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For example, in the following program; 


100 INPUT A$, B$ 

200 PRINT A$, BS 

RUN 

2 SMITH, JOHN, JONES, TED 
“EXTRA IGNORED 

SMITH JOHN 


A$ would be assigned “SMITH”, and B$ would be assigned 
“JOHN”. “JONES” and “TED” would be ignored as the error 
message (?7EXTRA IGNORED) illustrates. 


Therefore, when inputting a string item, be certain a comma 
does not appear within that string. 


The variable type used with INPUT should be of the same type as 
the data input. String data cannot be input into numeric 
variables. If this does occur, the error message ?REENTER will 
appear, and the operator will be prompted for a new entry. If a 
real number is input for an integer variable, the decimal portion 
of the real number will be truncated. If numeric data is input for 
a string variable, that data will be interpreted as a string and 
cannot be used in calculations. 


Itis good programming practice to include a prompt message in 
conjunction with the INPUT statement to remind the operator 
what data the computer is expecting. The prompt should be 
enclosed within quotation marks after INPUT. The prompt 
should be followed by a semicolon* and the variable or variables 
into which data is to be input. The prompt message will be 
displayed on the screen followed by the ? prompt. An example 
of an INPUT statement with a prompt is given as follows. 


100 INPUT “CUSTOMER NAME_ ”; A$ 
200 PRINT A$ 











* In Integer BASIC, the prompt is followed by a comma. 


INTRODUCTION 


The Apple Ie User’s Handbook is meant to serve as a tutortal as 
well as an ongoing reference guide to the Apple Ile personal 
computer. The latest features of the Apple Ile are discussed in 
detail including the 80 column card and the new Ile keyboard. 


Chapter 1 of this book is intended to serve as an introduction to 
the lle. The system board, expansion slots, speaker, video dis- 
play, cassette recorder, disk drive, and BASIC interpreter are all 
discussed in this chapter. Terms basic to computing such as 
RAM, ROM, byte, bit, software, modem, operating sytem, inter- 
preter, compiler, and assembler are all defined in Chapter 1. 


Chapter 2 describes Apple Ile installation, operation, and trou- 
bleshooting. Keyboard usage is discussed in detail in this 
chapter. 


Chapter 3 ts meant to serve as tutorial on Applesoft and Integer 
BASIC programming on the Ile. Topics such as BASIC start-up, 
switching from Applesoft to Integer, constants, variables, strings, 
arrays, operators, loops, functions, conditional statements, and 
branching statements are discussed in detail. Chapter 3 assumes 
the user has some familiarity with BASIC programming and ts not 
meant to serve as an introductory guide to programming for the 
first-time user. 


Chapter 4 serves as a detailed reference guide to each of the 
various commands and functions available tn both Integer and 
Applesoft BASIC. 


Chapter 5 includes a detailed discussion of data storage on 
cassette or diskette with the Apple Ile. Each of the DOS 3.3 
commands are discussed in detail. Files and tile handling are also 
discussed. 


Chapter 6 includes a detailed discussion of programming gra- 
phics on the Apple lle. 


Chapter 7 describes the usage of the Ile’s system monitor and 
mini-assembler. 


Chapter 8 discusses the usage of the lle’s optional 80-column 
board. 


The Apple Ie User's Handbook includes nine useful appendices. 
These detail the various Applesoft, Integer, and DOS reserved 
words and error messages, the ASCII code set, printer usage with 
the Ile, and the various monitor subroutines. 


CHAPTER 1. INTRODUCTION 
TO THE APPLE Ile. 





HISTORY OF THE APPLE Il 


When the Apple II computer was first introduced in the summer 
of 1977, it was one of the first fully assembled microcomputers 
available. The Apple I! was designed by Steven Jobs and Steven 
Wozniak in a garage in Los Altos, California. 


From this humble beginning, the Apple II has evolved into a 
complete line of microcomputers, peripherals, and software. 
Apple computers can be found in homes, offices, small 
businesses, and factories throughout the world. Apple 
Computer, Inc. has grown into a multi-million dollar, multi- 
national firm in just a few short years. 


HISTORY OF THE APPLE He 


The Apple Ile was introduced in the spring of 1983. The Ile is a 
redesigned version of the Apple II. The Ile contains 64K of RAM, 
an expanded keyboard with 63 keys that can output both upper 
and lower case characters, an optional 80-column display and a 
6502B CPU (a high-speed version of the original 6502). 


The Apple Ile includes both Applesoft and Integer BASIC. 
Applesoft BASIC is included in the ROM, and Integer is loaded 
from the System Master diskette. 


The Ile uses the same Disk II drive used with the earlier Apple II 
models. DOS version 3.3 is used with the Ile. 


*Although this book is dedicated to the Apple Ile, the majority of the concepts 
apply to the Apple II as well. 
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TYPICAL APPLE Ile SYSTEM 


A typical Apple Ile system is depicted in Illustration 1-1. Your 
Apple Ile system may not include the exact components 
pictured in Illustration 1-1. However, every Apple Ile system 
must include at least two of the components shown in Illustration 
1-1--the Apple Ile computer and a monitor or television set. 


We will discuss the Apple Ile first, followed by the various 
peripherals that can be connected to this basic Apple Ile system. 
These peripherals include a monitor or TV set, cassette recorder, 
Apple Ile Disk Drive, printers, and the various Apple controllers 
or cards. 


Illustration 1-1. Typical Apple Ile System 
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Inside the Apple Ile 


The Apple Ile consists of the 6502B microprocessor, RAM 
memory, ROM memory, slots for the connection of controller 
cards, a power supply, a speaker, game I/O connectors, a video 
connector, a cassette interface, and a keyboard all enclosed ina 
protective case. The inside of the Apple Ile is shown in 
Illustration 1-2. 


Main Board 


Once you have opened your Apple Ile you will notice a large 
green printed circuit board at the bottom of the open com- 
partment. This board is known as the main board. The main 
board contains the various IC chips and components that control 
the Apple lle. 


illustration 1-2. Inside of the Apple Ile 





1. Internal Power-On Light 2. Expansion Slots 3.6502B Microprocesspor 4. 
Power Supply 5. Auxiliary Slot with80 Column Board 6.Memory 7.Speaker 
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Perhaps the most important component on the main board is the 
6502B microprocessor. As shown in Illustration 1-2, the 6502B 
microprocessor is located in the center of the main board just 
below the seven slots. The 6502B is a high speed version of its 
predecessor, the 6502. The 6502 was used in the Apple II and II 
Plus. The 6502B can address 64K of RAM. However, the Ile has 
incorporated special memory banking and switching techniques 
to allow more than 64K to be addressed. 


Several other important components of the main board are 
depicted in Illustration 1-2. These include an AY-3600 integrated 
circuit and a ROM chip that are used to encode the keyboard 
characters. The main board also includes two ROM chips that 
contain the Applesoft BASIC interpreter. 


The main board contains an MMU integrated circuit which 
controls memory addresses within the lle, and an IOU integrated 
circuit which controls the built-in input/output features of the 
Ile. 


Eight RAM IC chips are located at the bottom right of the main 
board. These supply the Ile with 64K of RAM. 


Expansion Slots 


Towards the rear of the main board are located seven expansion 
slots. These slots allow additional hardware devices to be 
installed with the Apple Ile. For example, an expansion card is 
available that enables the Ile to run the CP/M operating system. 
Also, controller cards must be installed in these slots to enable a 
printer or disk drive to be used with the Ile. 


Notice that these seven slots are numbered from 1 through 7. In 
the Apple II, eight slots (numbered 0 through 7) were available. 


Auxiliary Slot 


Notice the large expansion slot located on the left side of the 
main board. This is known as the auxiliary slot. If your He 
contains the 80-column text option, the 80 column text card will 
be installed in this slot. 
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Rear Panel 


The bottom left-side of the rear panel of the Apple Ile (see 
Illustration 1-3) contains a 9-pin D-connector for the installation 
of hand controls, two phone jacks for the installation of a 
cassette recorder, and an RCA type jack for the installation of a 
video monitor. 


The bottom right-hand side of the Ile’s rear panel contains the 
AC cord socket and an on/off switch. Both of these are 
connected to the power supply. 


Finally, note the rectangular openings along the Ile’s rear panel. 
These openings are numbered from 1-12. When the lle is 
connected to one or more peripheral devices using an interface 
card, that card’s connector is attached to the proper opening. 
Openings 1 through 4 are used for 19-pin connections; 5,6,8 and 
9 are used for 9-pin connections; and 7, 10, 11, and 12 are used 
for 25-pin connections. 


Illustration 1-3. Apple Ile Rear Panel 





1. Video Monitor Jack 2. Cassette Recorder Input/Output Jacks 3. 
9-pin D-Connector 4. Rectangular Openings 5. AC Cord Socket 6. 
On/Off Switch. 
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Bits & Bytes 


Microprocessor logic is based upon the bit. A bit is the basis of all 
information storage within the computer. A bit consists of a 
simple switch that can consist of either of the two binary states, 
on or off. 


Bits are often separated into groups of eight. These groups of 8 
bits are known as a byte. A byte is required to represent a single 
character (i.e. letter, number, or symbol). Generally, bytes are 
processed by the computer in groups of 2. 


Most of the 8-bit microprocessors can only address (or work 
directly with) 65,535 (64K) bytes at any one time. Even though this 
number appears large, a 30 page document would fill this 
memory area. The Apple Ile uses an 8 bit microprocessor. 
However, due to the usage of special memory banking and 
switching techniques, the Ile can address over 64K of memory. 


Most 16-bit microprocessors can address from 65535 to 16 
million bytes of memory. Moreover, 16 bit microprocessors 
process data at a speed from 2 to 10 times faster that 8-bit 
microprocessors. The IBM Personal Computer is an example of a 
computer that uses a 16 bit microprocessor. 


ROM and RAM 


ROM stands for Read-Only Memory. ROM will hold the data 
stored in it permanently. If the power to the Apple is shut off, the 
information stored in ROM will remain there. As previously 
mentioned, the Apple’s BASIC language interpreter is stored in 
ROM. 


RAM stands for Random Access Memory*. Any data stored in 
RAM is lost when the Apple’s power is shut off. When data is 


* Random Access Memory is a somewhat misleading term to 
describe RAM, as most memory (including ROM) is randomly 
accessed. 
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loaded from a tape cassette, a disk drive, or the keyboard, it is 
stored in RAM. For example, when a program is loaded from the 
Apple Disk I, it will be stored in RAM. 


Dynamic and Static RAM 


There are two different types of RAM memory; dynamic RAM 
and static RAM. Dynamic RAM can only hold the data it is storing 
for a few milliseconds. Therefore, any data being stored in 
dynamic RAM must constantly be rewritten or refreshed. This 
dynamic RAM refresh function must be a part of the support 
logic when the dynamic RAM memory is designed. 


Static RAM is more expensive than dynamic RAM. However, 
once data has been written into static RAM, it will be retained as 
long 2s power is supplied. 


Apple Ile Power Supply 


The Apple Ile’s power supply is located on the left side of the 
inside of the unit as shown in Illustration 1-2. The power supply 
will supply four voltages: +5v, -5v, +12.0v, and -12v. 


The Apple’s main power cord plugs into the power supply on the 
back of the Apple. The Apple’s power-on switch is also located 
on the back of the power supply. This is pictured in Illustration 
1-3. 


Some Apple’s have a power supply with a switch which allows 
the user to select either 110 or 220 volts. 


Apple Ile Speaker 


As pictured in Illustration 1-2, the Apple Ile’s speaker is located 
inside the case on the lower left hand side. The speaker is 
connected to the Apple so that a program can be used to create 
sounds on it. 


The Apple Ile’s speaker is controlled by a soft switch. Soft 
switches have two states (ex. in/out; on/off; text/graphics). By 
addressing a special memory location associated with the soft 
switch, a program can change the state of the switch. 
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It is unimportant what data values are actually read from or 
written into the memory address associated with a soft switch. It 
is the reference to that address that throws the switch. The data 
written to or read from the location has no effect. 


Machine language programs should reference the hexadecimal 
value for the memory address associated with the soft switch. 
BASIC programs should use a read operation to the decimal 
value for the memory address associated with the soft switch. A 
write operation causes such a short pulse that the speaker will 
not emit a sound. 


The memory address for the soft switch associated with the 
speaker is 49200 or hexadecimal CO30H. Whenever this address is 
referenced in a program, the speaker will emit a small click. By 
continually referencing this address, the speaker will generate a 
continuous tone. 


APPLE Ile VIDEO DISPLAY 
Monitor/TV Set Connection 


The Apple Ile can either use a monitor or a regular TV set for 
video output. The connection between the Ile and a monitor is 
simple. Merely use a video cable to connect the video port on the 
rear of the Ile to the video input port on the monitor. This 
connection is depicted in Illustration 1-4. 


The connection between the lle and a TV set is somewhat more 
complicated due to the fact that the Ile’s video signal must be 
converted toa signal that can be comprehended by the TV set. A 
device known as an RF modulator must be installed in the Ie in 
order to convert the lIle’s video signal. The RF modulator is 
generally connected to a group of four Molex-type pins on the 
rear right-hand side of the main board. 


A switch box is also generally connected to the VHF terminals of 
the TV set’s antenna box. This switch box enables the TV set to be 
operated normally in one setting; while in the second setting, it 
serves as the lle’s video output device. The installation of the TV 
switch box is depicted in Illustration 1-5. 
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Modulators are also available which can be connected directly 
to the VHF terminals in the TV set’s antenna. If this type of 
modulator is directly connected to the TV set, acable can be run 
from the video out port on the rear of the Ile to the modulator to 


make the proper connection. 


Illustration 1-4. Apple Ile/Monitor Connection 





1. Video Cable Connector 


Illustration 1-5. Apple Ile/TV Set Connection 
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Apple Ile Video Display Formats 
The Ile can display the following four types of video output: 


40-column text mode. 

80-column text mode (with optional 80-column card). 
Low-resolution graphics (40 x 48 with 16 colors). 
High-resolution graphics (280 x 192 with 6 colors). 


In the text mode, the Ile has the capability to display 24 lines with 
40 or 80 columns per line. The characters in the 80 column mode 
are only half as wide as those in the 40 column mode. For this 
reason, the 80 column text mode generally cannot be used with a 
regular color or B&W television set as the resultant output is so 
blurred that it is unreadable. A high-resolution video monitor 
must be used to obtain clear output in the 80-column text mode. 


In the text mode, any of the 96 ASCII characters can be displayed 
including lower and upper-case letters numbers, and symbols. 
The text characters are generally displayed as white dots on a 
black background. However, text characters can also be display- 
ed as black characters on a white background. This type of 
display is known as the inverse format. 


Each individual character is displayed on a matrix seven dots 
wide by eight dots high. The character itself is only five dots 
wide. This leaves one blank dot on either side of the character. 
Therefore, a total of two rows of blank dots are allowed between 
characters. With the exception of lowercase characters with 
descenders characters are created seven dots high. This leaves 
one blank line of dots between characters. 


Two different character sets are available in the text mode: the 
primary character set and the alternative character set. The 
characters themselves are identical in each character set. How- 
ever, the format in which the characters are displayed differs. 
The following formats are available: 


normal - white dots on black background. 
inverse - black dots on a white background. 
flashing - alternating between normal and inverse. 
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In the primary character set, the lle can display uppercase 
characters in either the normal, inverse or flashing formats. 
Lowercase letters can only be displayed in the normal format. 


In the alternative character set, the tlashing tormat for uppercase 
and lowercase letters is unavailable. However, the normal and 
inverse formats for both upper and lowercase letters is available. 
The alternative character set is used when the 80-column card Is 
active. 


In low resolution graphics, the Ile can display 1920 blocks of data 
within an array that measures 48 blocks high by 40 blocks wide. 
Each block can be assigned any one of the following 16 different 
colors available with low resolution graphics. 


Black Brown 
Magenta Orange 
Dark Blue Grey 2 
Purple Pink 

Dark Green Light Green 
Grey 1 Yellow 
Medium Blue Aquamarine 
Light Blue White 


No empty space exists between blocks. Therefore, if a group ot 
several adjacent blocks are assigned the same color, they will 
appear as a single mass. 


High resolution graphics consists of 53,760 dots in 280 dot wide 
by 192 dot high array. The dots used in high resolution graphics 
are the same size as the dots used to make up characters in the 
text mode. 


The following six colors are available in the high resolution 
graphics mode: 


black blue 
white green 
orange purple 


Every dot in high resolution graphics can either be black, white, 
or one of the colors. However, every color is not available for 
every dot in high resolution graphics. 
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In either low or high resolution graphics, the user can include 4 
lines of text at the bottom of the display. In low resolution 
graphics, these 4 lines of text replace the final 8 rows of blocks. In 
high resolution graphics, they replace the lower 32 rows of dots. 
These display modes which contain both text and graphics 
characters are known as mixed modes. 


Cassette Recorder 


Your Apple Ile can be connected to a cassette recorder via the 
cassette interface. The cassette recorder can be used to store 
programs or data transferred from RAM. These programs or data 
later can be transferred back into RAM. 


The cassette interface jacks are located on the rear of the Ile. The 
cassette interface jacks can be used to connect the Apple to a 
standard cassette tape recorder. The tape recorder can be used 
as a data storage device for the Apple. 


The two cassette interface jacks are labeled with iltustrations. 
The output jack is labeled with a picture of an arrow pointing 
towards a cassette. The input jack is labeled with a picture of an 
arrow coming from a cassette. 


The cassette input jack should be connected to the cassette 
recorder’s earphone or monitor output jacks. The input jack will 
listen to the tones on the cassette tape, translate those tones into 
data, and then store them in memory. 


The OUT or output jack should be connected to the cassette 
recorder’s microphone input jack. The output jack is connected 
toa soft switch just as the Apple speaker is. The cassette’s output 
jack soft switch memory address is 49184 (-16352 Integer BASIC). 
By referencing this address, the voltage at the output jack will be 
varied, causing a tone to be produced on the tape. By altering 
the pitch and duration of this tone, data can be recorded on the 
cassette tape. 


An Apple Ile/cassette recorder hook up is pictured in Illustra- 
tion 1-6. The cassette recorder will be covered in more detail in 
Chapter 5. 
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illustration 1-6. Apple Ile Hookup to Cassette Recorder 





1. Output Jack 2. Input Jack 


Apple II Disk Drive 


A floppy disk system is a much more efficient means of data 
storage than is a cassette recorder system. The name of the 
floppy disk system used by the Apple Ile is the Disk II. The Disk II 
system includes a disk drive, disk controller card, and a cable 
used to connect the disk controller card to the disk drive. (see 
Illustrations 5-8 and 5-9). 


The Disk II’s controller card is installed in one of the expansion 
slots in the Ile’s main board. The Disk II’s operation and 
programming will be discussed in detail in Chapter 5. 


Printers 


A printer can be connected to the Apple Ile either via a serial 
interface card or a parallel interface card. The type of card used 


depends on whether the printer being connected is a serial or 
parallel device. 
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Data may be sent from the computer to the receiving device 
(printer or video display) in two different manners; serial and 
parallel. In parallel communications, the 8 bits representing a 
character are all sent at one time to the receiving device. In serial 
communications, each of the 8 bits are sent one at a time to the 
receiving device. Generally, printers use parallel communication. 


A wide range of printers are available for use with the Apple Ile. 
The printer interface card can be installed in slots 1-7 in the main 
board. Generally, openings 7, 10, 11, or 12 on the rear of the Ile 
are used for the installation. 


The use a printer with the Apple Ile will be covered in greater 
detail in Appendix H. 


Hand Controls 


The 9-pin connector in the lle’s rear panel is generally used for 
the installation of hand controls such as game paddles, a joystick, 
etc. 


A Game I/O Connector is also available on the main board (see 
Illustration 1-2). Controllers using a 16-pin connection can be 
attached via the connector. 


Apple Ile Controller Cards 


Earlier in this chapter, we mentioned the seven plug-in slots on 
the Apple’s main board. The slots were designed to accept 
special circuit boards known as controllers or cards. 


Cards are available for a number of different applications. For 
example as we mentioned previously, a parallel or serial 
communications card is required to install a printer on your 
Apple Ile. Controller cards are required for installing a disk drive 
with you Apple Ile. 
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A number of other cards are also available for the Apple Ile. 
These include communications cards which allow you to con- 
nect you Apple Ile to a modem, which in turn allows your Apple 
to accept data transmitted over telephone lines. Cards are also 
available which convert digital signals to analog and vice versa. 
Finally, cards are also available that allow the Apple He to run 
under an operating system completely different from Apple 
DOS known as CP/M 


Communications 


The Apple Ile can communicate with another Apple computer 
located a few miles away or a few thousand miles away. A device 
known as a modem, your telephone, and telephone lines allow 
this communication to take place. 


A modem converts signals generated by the Ile into signals 
which can be transmitted over telephone lines. A modem will 
also reconvert the signals transmitted over phone lines back into 
a signal which can be understood by the Ile. 


Generally, a modem is connected to the Ile using a Super Serial 
Card. Once the Super Serial Card has been installed (in slots 1-7), 
connect the card to the modem. Then, connect the modem to 
your telephone. 


A modem allows the user to access one of the many available 
information services. Examples of these information services include 
Compuserve, The Source, and the Dow Jones News and Quotes 
service. A modem also allows communications with other 
Apples. 


SOFTWARE 


Software can be described as the instructions or programs that 
cause the computer to operate. Several different classifications 
of software exist for the performance of different functions. 
These can be classified as operating systems, languages, and 
applications programs. 
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Operating Systems 


An operating system can be defined as a group of programs 
which manage the overall operation of the computer. The 
operating system performs system operations such as controlling 
data input/output, memory assignments, etc. 


The standard operating system supplied with the Ile with a disk 
drive is DOS 3.3. DOS stands for disk operating system. 


There are several other operating systems available for the lle. 
The most well-known of these is CP/M. To install CP/M, a Z80 
peripheral card must be installed in slot 7 of the Ile. The Z80 card 
contains a Z80 microprocessor. The Z80 is necessary to run 
CP/M. 


Language Translators 


Programs are generally written in a high-level language that is 
different from the instructions the computer uses. A program 
known as a language translator must be used to translate the 


high-level language into a form that the computer can compre- 
hend. 


There are three categories of language translators: interpreters, 
compilers, and assemblers. 


A compiled language program consists of the source code and 
the compiled code. The source code consists of the program 
statements in their original form. For example, the following is a 
line of source code from a program written in the CBASIC 
compiled language: 


100 INPUT “ENTER TODAY’S DATE:”; DATE.1 


The source code is processed by a program known as a compiler 
into the compiled code. The compiled code is very similar to the 
machine language used by the microprocessor. The compiled 
code is the code actually used when a compiled program is run. 
A program known as a run-time monitor is used to run the 
compiled program. 
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An interpreted language consists of only the source code. The 
source code is translated line-by-line directly into machine 
language instructions. The Applesoft BASIC language that is 
standard on the Ile is an interpreted language. 


An assembler translates program instructions one by one into 
instructions that the CPU can comprehend. 


Applesoft BASIC 


The most widely used language on the Ile is Applesoft BASIC. 
Applesoft BASIC is resident in ROM in the Ile’s main board. 
Applesoft BASIC is a floating point language. This allows it to 
process both very large and very small numbers. 


Integer BASIC 


Integer BASIC is automatically loaded into RAM when the 
system is booted from the DOS 3.3 System Master diskette. 
Unlike Applesoft BASIC, Integer BASIC does not have the 
capability to process numbers with decimal portions. 


Other Languages 


A number of other languages are available for the Ile including 
PASCAL, FORTRAN, Logo, PILOT, and 6502 Assembly Language. 


Applications Programs 


Applications programs are those written to accomplish a specific 
task. Examples of applications programs include word proces- 
sing programs, electronic spread sheets, data base systems, and 
accounting programs. Generally, applications programs are 
stored on cassette or diskette and are transferred into RAM, 
where the program is available to the computer. 


Some of the more popular applications programs available for 
the He include: 


28 Apple Ile Users Handbook 


Database: PFS: The Personal Filing System 
DB Master 
Quick File Il 

Electronic Visicalc 

Spreadsheets: Plan 80 

Word Wordstar 


Processors: Apple Writer 


CHAPTER 2. APPLE Ile INSTALLATION, 
TROUBLESHOOTING, AND OPERATION 


INTRODUCTION 


In this chapter, we will explain in detail steps involved in 
installing the Apple Ile. We will then outline a few trouble- 
shooting hints for the He. Finally, we will discuss Ile operation. 


INSTALLATION 


The first step in installing the Ile is to position the console ona 
flat desk or table near a household AC outlet. 


The next step is to connect the AC power cable to the power 
cord outlet on the rear of the Ile. Then, connect the other end of 
the AC power cable to a household outlet. Turn the power 
switch (on the Ile’s rear panel) to the on position. If the 
connection was properly made, the Ile should power on. 


You are now ready to install a monitor or TV set as described in 
Chapter 1. Be certain to turn off the lle’s power switch and 
unplug the power cord prior to making this connection. 


TROUBLESHOOTING 


Table 2-1 contains a number of hints that may be able to help 
you isolate any problems should your Ile not function properly. 
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Table 2-1. Apple He Troubleshooting Hints 


Symptoms of 
Problem 


Apple lle powers 
on, but cursor does 
not appear. 





Apple Ile will not 
power on. 


Program will not 
load from cassette 
recorder. 





SYNTAX ERROR 
message. 


Possible Solution 


Be sure that the video display is 
plugged in and turned on. 
Check the display’s contrast and 
brightness controls. If the pre- 
ceding solutions do not solve 
the problem, disconnect all peri- 
pherals from the Ile except the 
display and run the lle’s selftests 
(explained later). 


Check to be sure that the power 
cord is properly connected to 
both the tle and to the wall 
outlet. Be sure that the wall 
outlet is receiving power. 


Check the cassette tape to be 
sure that it has been rewound. 
Also, check the cable connec- 
tion between the recorder and 
the Ile. Check the volume set- 
ting on the cassette recorder. 
Finally, certain recorders do not 
work well with the Ile. If you 
suspect this to be the problem, 
try another recorder. 


This is generally due to the incor- 
rect entry of an Applesoft or 
Integer BASIC command. Be 
careful not to use lower-case 
characters in reserved words. 
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Table 2-1. Apple Ile Troubleshooting Hints (con’t.) 


Symptoms of 


Problem Possible Solution 


Must Boot From Slot The PASCAL operating system 

6 message. must be booted with the system 
diskette in drive 1—which must 
be attached via slot 6. If nec- 
essary, reinstall the disk control- 
ler in slot 6. 


Disk drive’s in use Check to be certain that the 

light remains on. drive’s door is closed. Try pres- 
sing Ctrl-Reset to stop the 
drive. 


Drive emits weak If a card is installed in the auxil- 

sounds while iary slot, the disk controller card 

rotating. should not be installed in slot 3. 
Reinstall the disk controller 
card in a different slot. 


occasionally rattles 
during operation. 


was properly formatted. Be cer- 
tain that the disk was properly 
inserted into the drive. 





Disk drive | Be sure the diskette being used 
| 
| 


Built-In Self Tests 


The Ile contains a series of built-in self-tests designed to evaluate 
the operation of the unit’s internal circuitry. These tests do not 
check the operation of any devices attached to the Ile. 


To begin the self-test, press the Solid Apple and Ctrl-Reset keys 
simultaneously. Release Ctrl-Reset first followed by the Solid 
Apple key. 


The self-tests require approximately 20 seconds of execution 
time. During the self-tests, patterns will move across the screen. 
Upon successful completion of the tests, the following message 
should appear on the screen: 
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KERNEL OK 


If any other message appears, the Ie requires servicing. 


APPLE He OPERATION 


The He is started up by booting DOS (abbreviation tor disk 
operating system) from the System Master diskette. The System 
Master diskette is included with your Apple Ile Disk II drive and 
is labeled “DOS 3.3 System Master.’’ You can either use that 
diskette or a copy to start up the lle. It is recommended that once 
you learn diskette copying procedures (see Chapter 5), you use a 
copy of the System Master diskette for everyday lle operations. 


To insert the diskette, open the drive door to drive 1. The System 
Master must be inserted in drive 1. This is the drive attached to 
the controller card in slot 6. Insert the System Master diskette 
into the drive with its label facing up. The label side should be 
nearest your hand and the side of the diskette with the oval slot 
should be inserted into the drive. Once the diskette is in place, 
close the drive door. 


Next, power on the monitor connected to the Ile. Then, power 
on the lle itself by pressing the toggle switch located at the rear 
of the unit next to where the power cord plugs into the machine. 
The lle will beep, the disk drive will spin, and the drive light will 
blink on and off as DOS ts loaded. The green power light to the 
lett of the open Apple key will aiso be lighted and the display 
depicted on page 33 will appear on the monitor. 


The symbol | is the Applesoft BASIC prompt. When the symbol 
appears, the user can enter either Applesoft BASIC or DOS 
commands. 


Apple lle Installation, Troubleshooting and Operation 33 


APPLE II 
DOS VERSION 3.3 SYSTEM MASTER 
JANUARY 1, 1983 
COPYRIGHT APPLE COMPUTER, INC 1980,1982 





Apple lle Keyboard 

The‘Apple Ile keyboard is depicted in Illustration 2-1. The Apple 
lle keyboard is arranged differently than the keyboard on the 
Apple II or II Plus. 


First of all, the Ile contains 12 additional keys. These new 


Illustration 2-1. Apple Ile Keyboard 
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keys include: 


DELETE 
TAB 
CAPS LOCK 


4 
Y 


Open Apple Function Key 
Solid Apple Function Key 
Special Character Keys 


The REPT key on the Apple Il and II Plus has been replaced with 
an auto-repeat feature in the lle. The auto-repeat feature causes 
all printing characters to automatically repeat if the key is held 
down longer than a second or two. 


The Apple Ile keyboard allows the user to send any one of 128 
ASCII characters to the computer. Of these 128 characters, 96 are 
printing characters. That is, they will be echoed on the screen 
when entered at the keyboard. The printing characters include: 


26 lowercase letters 

26 uppercase letters (output with caps lock or shift 
depressed) 

10 numerics 

34 special characters 


The non-printing characters consist of the 32 control characters. 
The control characters are output by simultaneously pressing the 
Control key with a second key (generally a letter). 


Several of the control codes can also be output via special keys 
on the Ile keyboard. For instance, the same control code that is 
output by Ctrl-M is also output by the Return key. Therefore, the 
ASCII return code (ASCII 13 decimal) can be produced in two 
separate ways. 


Asa general rule, the printing characters are used for outputting 
information, while the control characters are used to instruct the 
system to perform some function. 
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We will discuss the more important keys on the Ile keyboard in 
more detail in the following sections. 


Space Bar 


The space bar (located at the bottom of the Ile keyboard) 
generates the space character (ASCII 32 decimal). Be certain to 
include the space character where specified in DOS or BASIC 
commands. 


Shift 


The Shift key causes the uppercase character to be output for the 
key being pressed. There are two Shift keys on the Ile keyboard, 
one on the left and one on the right side of the keyboard. 


Caps Lock 


The Caps Lock key is located just below the Shift key on the 
left-hand side of the keyboard. When the Caps Lock key is on 
(depressed), all alphabetic keys will be output as uppercase 
characters. No other keys will be affected. This allows the user to 
output only uppercase letters, while still being able to enter 
numbers. 


Once Caps Lock is on (depressed), it can be turned off by 
pressing the key a second time. When the key is pressed, it clicks 
back into the up position. 


Cursor Control Keys 


The cursor control keys can be used to move the cursor around 
the screen. The cursor control keys are described below: 


Left-Arrow Moves the cursor one position 
to the left. 
Right-Arrow Moves the cursor one posi- 


tion to the right. 
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Down-Arrow Moves the cursor down by 
one line. 

Up-Arrow Moves the cursor up by one 
line. (ESC key must first be 
pressed.) 

Tab Moves the cursor to the next 


tab setting. Tabs generally are 
set after every eight char- 
acters. This key only functions 
with certain programs (gener- 
ally word processing soft- 
ware). 


Return Moves the cursor to the be- 
ginning of the next line. 


ESC Key 


The ESC key outputs the control code for ESC (ASCII 27 decimal). 
The ESC key is often used to either place the computer in the 
escape mode or to enter an escape sequence. 


Open Apple Key 


The Open Apple key appears to the left of the space bar. The 
Open Apple key can be used to restart the Ile when it has already 
been powered on. This is accomplished by pressing the Open 
Apple key simultaneously with Ctrl-Reset. 


Pressing the Open Apple key also has the same effect as pressing 
the button on game controller #0. The Open Apple key can be 
used as an alternative to pressing the game controller. 


Solid Apple Key 
The Solid Apple key is located to the right of the space bar. The 
Solid Apple key when pressed simultaneously with Ctrl-Reset 


starts the Apple Ile’s built-in self-test. 


The Solid Apple key also has the same effect as pressing the 
button on game controller #1. 
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Reset Key 


The Reset key is located to the right of the Delete key on the right 
hand side of the Ile keyboard. Pressing Ctrl-Reset causes 
execution of most Ile programs to stop. 


CHAPTER 3. 
APPLESOFT BASIC PROGRAMMING 





INTRODUCTION 


BASIC is the most widely used personal computer programming 
language with the Apple Ile being no exception. The Ile includes 
two different versions of BASIC; Applesoft and Integer. Apple- 
soft BASIC is contained in ROM and will be active when the Ile is 
started up. Integer BASIC is loaded from the System Master 
diskette when DOS is booted. 


Applesoft BASIC is a floating point language. This allows 
Applesoft to handle numbers with decimal portions, as well as 
extremely large and small numbers expressed in decimal 
notation. 


Integer BASIC can only deal with integers. Obviously, Applesoft 
is amore practical version of BASIC then Integer. For this reason, 
our discussion of BASIC programming will be centered around 
Applesoft BASIC. 


Switching from Applesoft to Integer & Vice Versa 


As mentioned in the preceding section, Applesoft BASIC will be 
active when the lle is started up. If you wish to switch to Integer 
BASIC, enter INT via the keyboard. The Integer BASIC prompt 
(=> ) will appear. 


If you wish to switch back to Applesoft BASIC, enter FP via the 
keyboard. The Applesoft BASIC prompt (]) will appear. 
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Compiled & Interpreted Languages 


The conversion froma high level language to machine language 
is either done with an interpreter or a compiler. A compiler is a 
program that converts an entire high level program to machine 
language. A compiler performs a complete translation of the set 
of instructions before the program is actually executed. An 
interpreter converts each instruction to machine language as the 
program is executed. 


A compiled language such as CBASIC executes programs very 
quickly. However, an interpreted language such as Applesoft 
BASIC is easier to use, because it does not need to be compiled. 
Unfortunately, interpreted languages require more time to 
execute because each instruction must be translated into 
machine language as the program proceeds. 


Immediate & Program Modes 


The immediate mode is also known as the direct or the calculator 
mode. In the immediate mode, most BASIC command entries 
result in the instructions being executed without delay. For 
example, if the following immediate mode line was entered: 


PRINT “JIM SMITH” 
the following would be displayed on the video screen: 
JIM SMITH 
Inthe program or indirect mode, the computer accepts program 
lines into memory, where they are stored for later execution. 
This stored program is executed when the appropriate 


command (generally RUN) is entered. 


Illustration 3-1 contains an example of the entry of a program in 
the program mode and its execution. 
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Illustration 3-1. Program Mode Entry & Execution 


] NEW 

110 PRINT “JIM SMITH” 

] 20 PRINT “1220 EUCLID AVE” 

] 30 PRINT “CLEVELAND, OH 44122” 
] 40 END 

] RUN 

JIM SMITH 


1220 EUCLID AVE 
CLEVELAND, OH 44122 





Line Numbers 


In the program mode, program lines must begin with a line 
number. A line number is a one through five digit number 
entered at the beginning of a program line. The line number at 
the beginning of a program line is the only difference between it 
and an immediate mode line. 


No two line numbers can be the same. If the same line number is 
used more than once in a program, the line most recently 
entered will replace the original. 


The execution sequence of a BASIC program is determined by 
the value of its line number. The lowest line numbers will be 
executed first, followed by program lines with higher line 
numbers. Even if program lines are not arranged in sequential 
order, the Applesoft BASIC interpreter will place the lines in the 
correct order. 
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Adding program lines to a program stored in RAM is very easy. 
Just type in the line number followed by the program line. The 
line will be inserted in the program in the position indicated by 
its line number. For example, by adding the following line to the 
program in Illustration 3-1: 


35 PRINT "216-777-5579" 


the phone number for Jim Smith will be displayed on the line 
following his city, state, and zip. 


Program lines can be deleted by typing the line number to be 
deleted followed by Return. For example, the following entry: 


30 
would result in line 30 being deleted. 


Program lines can be changed by merely retyping the new line. 
The existing line in the Ile’s memory will be replaced with the 
new line. For example, the following entry: 


10 PRINT “THOMAS HILL” 


would result in “THOMAS HILL” being output rather than “JIM 
SMITH” in the program Illustration 3-1. 


NEW Command 


You may have noticed the execution of the NEW command in 
Illustration 3-1. The NEW command is used to erase an old 
program from memory before a new one is typed in. 


The Ile can only store one program in RAM at any one time. If 
you attempt to enter a new program while another program is 
already stored in RAM, the new program will be merged with the 
existing program. 


END Statement 


Notice the last line in the program in Illustration 3-1. That line 
consists only of the line number plus the BASIC reserved word 
END. 
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The END statement identifies the end of a program, and instructs 
BASIC to return to the immediate mode. Obviously, the END 
statement should be the last line in your program. 


Actually, Applesoft BASIC does not require an END statement. 
When the program’s final statement is executed, it will end. 
However, it is good programming practice to end a BASIC 
program with the END statement. Integer BASIC does require an 
END statement. 


Executing a Program 


A program is executed in the program mode by entering the 
RUN command. This is shown in Illustration 3-1. Every time RUN 
is executed, the program will be re-executed. As previously discussed, 
in the immediate mode, each program line will be executed 
when the Return key is pressed. 


Program Lines & Display Lines 


A display line can be defined as one row on the video display. A 
program line is regarded by the BASIC interpreter as one line, 
regardless of the number of display lines it occupies on the 
screen. The end of a program line is signalled when the Return 
key is pressed. Program lines are generally limited to 255 
characters. 


Multiple Statement Program Lines 
A statement can be defined as an instruction to the computer. 
The terms statement and command are often used interchange- 
ably. Most programs consist of a large number of statements. 
The following are examples of statements: 

PRINT “TIM GREGORY” 


070 DIM A(15) 
100 C=2*B 
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Every statement in Applesoft BASIC must contain at least one key 
or reserved word. A keyword identifies the calculation, decision, 
input, or output function to be performed. The keywords are 
described individually in Chapter 4 and are listed in alphabetical 
order in Appendices A and B. 


In addition to keywords, numeric constants, string constants, 
variables, and special symbols may appear in a BASIC statement. 
These are known as the statement parameters. 


Applesoft BASIC allows the user to place more than one 
statement ona single program line. Multiple statements must be 
separated with a colon (:). The following is an example of a 
multiple statement program line: 


10 A=B*7:PRINT B 
Listing a Program 
As mentioned earlier, the LIST command can be used to display 
program lines currently stored in RAM. Remember, if the NEW 
command is issued, the program in RAM will have been erased, 
and can no longer be displayed by LIST. 
LIST is used in the following configuration:* 


LIST [line 7 - line 2]** 


where line 7 is the line number of the first line to be listed, and 
line 2 is the line number of the last line to be fisted. 





*In this book, a standard format will be used to describe BASIC 
keyword configurations. The keyword will be displayed in our 
regular type style in upper case. Parameters will be displayed in 
our italic type style in lower case. Optional parameters will be 
enclosed in brackets. 


** This option is only available in Applesoft. A comma may be 
substituted for the hyphen. 
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LIST can be used without any parameters to list the entire 
program. LIST can also be used with a single line number to list 
just that program line. If LIST is used with the following format: 


LIST fine 1- 
line 1 and all subsequent lines will be listed. 
If LIST is used as follows: 

LIST -line 2 


line 2 and all lines preceding it will be listed. 


In certain situations (especially when a long program is being 
listed, you may wish to cancel or temporarily halt a program 
listing. With the Ile, you can cancel an Applesoft program listing 
by pressing Ctrl-C. 


A program listing can be stopped temporarily by pressing Ctrl-S 
and resumed by pressing the space bar. 


Error Messages 
When the Ile encounters a statement with an error, an error 
message will be displayed. The error message will be displayed in 


the following formats: 


? SYNTAX ERROR ~*—Applesoft BASIC 
***SYNTAX ERROR~— Integer BASIC 


The various Applesoft and Integer BASIC error messages are 
described in Appendices D and E. 


BASIC PROGRAM EDITING 


In our discussion of the Ile keyboard, we mentioned several of 
the keys used in editing. These include: 


~<«— used to backspace the cursor. 
—-+ used to move the cursor foward. 
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t used to move the cursor up. 
| used to move the cursor down. 


The following keys and key combinations can also be used in 
editing: 


Ctrl-X erases the current line. 
Esc-@ clears the display and homes the 
cursor. 


Esc-A or K moves the cursor to the right. 
Esc-B or J moves the cursor to the left. 
Esc-C or M_ moves the cursor down one row. 


Esc-D or | moves the cursor up one row. 

Esc-E erases text trom cursor to end of line. 

Esc-F erases text from cursor to end of text 
windows. 


Once Esc I,J, K, or M has been pressed, the Ile will be in the edit 
mode. In the edit mode, it will no longer be necessary to press 
Esc with I,J, K,or Mto move the cursor. The cursor can be moved 
by pressing I,J, K, or M. The edit mode can be ended by pressing 
any key except I, J, K, M, Ctrl, or Shift. 


APPLESOFT BASIC DATA TYPES 


Data can be classified under two major categories: text and 
numeric. Text data consists of characters. These characters are 
generally used within strings. 


Examples of numeric data include: 


Integers 
Floating Point Numbers 
Scientific Notation 


Each of these data types will be discussed in the following 
sections. 


STRINGS 


A string consists of one or more characters enclosed within 
double quotation marks. The following are examples of strings: 
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“F, SCOTT FITZGERALD” 

“149 LEXINGTON AVE” 

“NEW YORK, NY 10017” 
“212-349-9879” 


Notice that a string can contain both letters, numbers and 
symbols. Any string containing numbers cannot be used in a 
mathematical operation, unless it is first converted into numeric 
data. String to numeric data conversion is covered later in this 
chapter. 


NUMERIC DATA 


The Ile can use either of two types of numeric data—integers and 
floating point numbers. Integers do not have a decimal portion 
while floating point numbers can have a decimal portion. 


Applesoft BASIC can process both integers and floating point 
numbers while Integer BASIC can only process integers. 


Floating Decimal Point 


With floating decimal point numbers, a decimal point is always 
assumed. Any number of digits can be placed on either side of 
this decimal point. Even with numbers with no decimal position, 
a decimal point always is assumed following the number's last 
digit. 

Floating point numbers of up to 9 digits can be used with 
Applesoft BASIC. For example, the following entry of a nine digit 
floating point number: 


PRINT .566666666 


would generate a nine digit display. If a 10 digit floating point 
number was entered: 


PRINT .5666666666 


the last digit would not be displayed and the number would be 
rounded as follows: 
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.566666667 


Commas may not be included within numeric data. For example, 
109000 would be a valid number in Applesoft BASIC while 
109,000 would be invalid. 


Floating point numbers include both integers, as well as numbers 
with decimal positions. The following are examples of floating 
point numbers: 


-.0789 
5 
77.39 
0 
+.000001 
67.98 


Negative floating point numbers should be preceded with the 
minus sign (-). Positive floating numbers can optionally be 
preceded with the plus sign (+), however, a floating point 
number is assumed positive if it doesn’t have a sign. 


integer 


An integer is a number without a decimal position. Integers can 
either be positive or negative. The following are examples of 
integers: 


-1134 
0 
1 
-1 
17945 
+32 


Integers can range from -32768 to +32767. Negative integers are 
preceded with the (-) sign. Positive integers can be preceded 
with the (+) sign, although integers without a (+) sign are assumed 
to be positive. 
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Scientific Notation 

Applesoft BASIC uses scientific notation to express either 
extremely large or extremely small numbers. A number in 
scientific notation takes the following format: 


+x E + yy 


Where; 


H- 


is an optional plus or minus sign. 


x can either be an integer or floating point number. 
This value is know as the coefficient or mantissa. 


E stands for exponent. 


yy isaone or two digit exponent. The exponent gives 
the number of places that the decimal point must be 
moved to give its true location. The decimal point is 
moved to the right with the positive exponents. The 
decimal point is moved to the left with negative 
exponents. 


The following examples specify a number in both standard 
floating point and scientific notation: 


1000000 —» 1 £6 
.000001 ——» 1 E-6 
57500000 ——» 5.75 E+07 
-.00000479 —» -4.79 E-06 


Any integers containing 10 or more digits will be expressed in 
scientific notation as shown in the following example. 


PRINT = 121212121212 
1.21212127E+11 
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Notice that the decimal portion of the preceding example 
contains 8 digits of precision. Applesoft will round any additional 
digits. 


Applesoft can only handle numbers expressed in scientific 
notation in the following range: 


Largest floating point number —» +1.70141183E+38 
Smallest floating point number —» +2.93873588E-39 


If a larger number is encountered, the following error message 
will be displayed. 


OVERFLOW ERROR 


Any numbers smaller than that allowed will be assigned a value 
of 0. 


VARIABLES 


So far, we have only discussed data constants. A constant can be 
defined as a fixed value. The following are examples of string and 
numeric constants. 


“JACK NOVET” 
375" 

27.59 

0 

100000 


A name can be used to express data as well as a constant. 
Variables are used to express data as a name. 


BASIC Variables 


A variable can be defined as a quantity that can assume any one 
of a group of values. Variables are represented by variable 
names. These consist of a letter followed optionally by additional 
letters and/or numbers. The value assumed by a variable is 
subject to change, depending upon the program statement 
being executed. For example, in the following: 
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100 LET A=5.0 
200 LET B=7.0 
300 LETA=A+B 


the variable A is initially assigned a value of 5.0 and B is assigned a 
value of 7.0. In line 300, the variable A is assigned a new value 
equal to the sum of variables A and B, which is 12.0. The previous 
value of A is erased. 


BASIC Variable Names 


Applesoft BASIC allows any group of up to 238 characters to be 
used as a variable name--as long as the first character of the 
group is a capital letter of the alphabet, and as long as the 
variable name does not duplicate a reserved word (see Appen- 
dices A & B). Examples of reserved words are: 


LET, GOTO, IF, READ, DATA 


The following are examples of valid Applesoft BASIC variable 
names: 


A JOHN 
B23456 N4N 
DOT B% 
A2 N 


While the following are invalid variable names: 


2BB7 END 
1A FOR 
PRINT COs 


All of the preceding examples of valid variable names should be 
used to represent numeric data. Variable names can also be used 
to represent string data. These are known as string variables. 
String variable names consist of a valid variable name followed 
by the dollar sign ($). The following are examples of valid string 
variable names. 
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A$ NED$ 
ZIP$ MOP$ 
A7$ N222$ 


A distinction can also be made among numeric variable names 
between floating point variable names and integer variable 
names. In the following example, A1 is used to represent a 
floating point number, while A% represents an integer. 


100 Al = 1.75:A% = Al * 2 
200 PRINT A1, A% 
RUN 

1.75 3 


Notice that only the integer value of A% is output. The decimal 
portion is dropped or truncated as A% can only accept integer 
values. 


Keep in mind that although Applesoft allows variable names of 
up to 255 characters, only the first 2 alphanumeric characters are 
recognized by the interpreter. In other words, the following 
variable names would be identified as being identical by the 
Applesoft interpreter. 


TELLER 
TENNIS 
TENNESSEE 


However, the special symbols which identify the variable type 
(i.e. $, %) differentiate among variables with identical 2 character 
names. The following variable names would all be identified as 
unique by the Applesoft interpreter. 


TE% 

TE 

TE$ 
TABLES & ARRAYS 


Earlier in this chapter, we introduced the concept of variables. A 
variable is designed to hold a single data item--either string or 
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numeric. However, some programs require that hundreds or 
even thousands of variable names be used. 


Obviously, the use of thousands of individual variable names 
could prove extremely cumbersome. To overcome this problem, 
BASIC allows the use of subscripted variables. Subscripted 
variables are identified with a subscript, a number appearing 
within parentheses immediately after the variable name. An 
example of a group of subscripted variables is given below: 


A(0), A(1), A(2), A(3), A(4),..., A(100) 


Note that each subscripted variable is a unique variable. In other 
words, A(0) differs from A(1), A(2), A(3), A(4), etc. 


Subscripted variables should be visualized as an array (or table). 
In our previous example, the data contained in the array defined 
by A would consist of one row with 101 columns in it. Such an 
array is a single-dimension array. 


In Applesoft BASIC, arrays of up to eleven*elements can be used 
as needed ina program. Arrays which contain more than eleven 
elements must first be identified via the Dimension (DIM) 
statement. When an array is dimensioned, BASIC will reserve an 
area in memory for that array’s elements. The following 
Dimension statement will dimension a numeric array of 16 
elements. 


100 DIM B(15} 


More than one array can be defined with a single DIM 
statement. This is shown in the example below: 


100 DIM Z(5,2), B(100), C(2,3) 





*An array of eleven elements would contain the subscripts 0 
through 10 inclusive. For example, an array dimensioned as A(10) 
would have eleven elements A(0) through A(10) inclusive. 
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A DIM statement should appear in a program before the array 
variable it is dimensioning appears. If an array variable is used in 
a program before it is dimensioned, the Bad Subscript error may 
occur. 


An array can also consist of two dimensions. Such an array is 
known as a two-dimensional array (or table). An example of an 
array of 4 rows and 3 columns is shown in Illustration 3-2. 


A two-dimensional array contains two subscripts. The first 
subscript contains the row location, while the second subscript 
contains the column location. The subscripted variable A(1,0) 
identifies the darkened area in the array shown in Illustration 
3-2. 


illustration 3-2. Two-Dimensional Array 


Columns 





Expressions and Operators 


The values of variables and constants are combined to form a 
new value through the use of expressions. The following are 
examples of expressions. 


4+7 
A$ + BS 
372 

14< 21 

X AND Y 


Applesoft BASIC includes several types of expressions including 
arithmetic, relational, and Boolean. in our previous examples, 
the first three examples are arithmetic expressions, while the 
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fourth and fifth are examples of relational and Boolean expres- 
sions respectively. Each of these types of expressions will be 
discussed in detail in the following sections. 


The sign or phrase describing the operation to be undertaken is 
known as the operator. The operators in our previous example 
were as follows: 


A «+ + 


AND 


The constants or variables which are affected by the operator are 
known as operands. 


Compound Expressions and Order of Evaluation 


All of our preceding examples were simple expressions. A simple 
expression is one which contains just one operator and one or 
two operands. Simple expressions can be combined to form 
compound expressions. The following are examples of 
compound expressions. 


(A +B) *7-4 
(A + B) AND (C + D) 
IF A=1AND B=1 THEN C=1 


With compound expressions, it is necessary that the computer 
knows which operation should be undertaken first. Applesoft 
BASIC follows a standard order of evaluation within compound 
expressions. This order is outlined in Table 3-1. 


Note that parentheses have the highest precedence level. In 
other words, any expression enclosed within parentheses will be 
evaluated first. If more than one set of parentheses appears in an 
expression, these will be evaluated from left to right. 


One pair of parentheses can be used to enclose an operator 
enclosed within another set. In such an instance, Applesoft 
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BASIC will evaluate the expression within the innermost set of 
parentheses first, followed by the next innermost set, etc. 


Table 3-1. Order of Evaluation 


Parentheses Used to alter order 
of evaluation. 





Exponentiation 
Unary Minus 
Arithmetic Multiplication 
Operators Division 
, Addition 
Subtraction 





Equal To 
Not Equal To 
Relational < Less Than 
Operators Greater Than 
= Less Than or Equal To 
Greater Than or 
Equal To 








Boolean Logical Complement 
Operators Logical AND 
Logical OR 





When expressions have the same order of evaluation, they will 
be evaluated in order from left to right within the compound 
expression. 


Arithmetic Operations 


The symbols used for addition, subtraction, multiplication, 
division, and exponentiation are known as arithmetic operators 
in BASIC. The symbols + and - are used for addition and 
subtraction respectively. The asterik (*) is used to indicate 
multiplication, while the slash (/) is used to indicate division. 
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When a+ or - sign precedes a number, the symbol is used to 
specify that number’s sign. When + or - is used to change a 
number's sign, that usage is known as a unary operation. Unary 
operators can be used to change the sign of a numeric constant 
or variable as shown below: 


100 LET A=-A 


When unary operators are used in the manner shown above, the 
unary operation is regarded as an arithmetic operation. 


The term arithmetic expression is used to describe the use of an 
arithmetic operator with numeric constants and/or variables. 
The following are examples of arithmetic expressions. 

X+Y+70 

100/A + B 

3000 * 10 +1 


Exponentiation is the process of raising a number to a specified 
power. For example, in the following, 


A5 


the numeric variable A would be evaluated as: 


A*A*A*A*A 


In Applesoft BASIC, exponentiation is indicated with the caret 
arrow symbol,A . 


Exponentiation can be used in an arithmetic expression as shown 
below: 


8*3+742 


The preceding expression would evaluate to 73. 
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A relational operation evaluates to either true or false. For 
example, if the constant 1.0 was compared to the constant 2.0 to 
see whether they were equal, the expression would evaluate to 
false. In Applesoft BASIC, a non-zero value represents a condi- 
tion of true, while a value of 0 represents false. 


The only values returned by a comparison in BASIC are 1 (true) 
or 0 (false). These values can be used as any other integer would 
be used. The following results are generated by the following 
relational expressions. 


5 >7 ——» 0 (false) 

3=3 ——» 1 (true) 

2<>2 —, 0 (false) 
(2=2)*4——>4 
aa 


The first three examples are easy enough to understand. In the 
fourth example, the relational expression (2=2) is evaluated first 
as true or 1. This result is then multiplied by 4 with a product of 4 
as the result. In the fifth example, the relational expression (1>7) 
evaluates as false or 0. This result is added to 7, with the result 
being 7. 


Relational operations using numeric operations are fairly straight- 
forward. However, relational operations using string values may 
prove confusing to the first-time computer user. 


Strings are compared by taking the ASCII value for each 
character in the string one at a time and comparing the codes. 


If the strings are of the same length, then the string containing 
the first character with a lower code number is the lesser. Blank 
spaces are counted in string comparisons and have the ASCII 
value of 32. 
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The following comparisons between strings would all evaluate as 
true. 


“ABC”’ = “ABC” 
“ABC ,? >“ABC”’ 
“BAA” > “AAA” 


“ALFRED” < “ALFREDO” 
A$ < Z$ where A$="ALFRED” and Z$="ALFREDO” 


Note that all string constants must be enclosed in quotation 
marks when used as constants. 


Logical Operators 


Logical or Boolean operations are generally used in BASIC to 
compare the outcomes of two relational operations. Logical 
operations themselves return a true or false value which will be 
used to determine program flow. 


The logical operators are NOT (logical complement), AND 
(conjunction), and OR (disjunction). These are best explained 
with a simple analogy. Suppose that Steve and Sherry were 
shopping in the produce department of their grocery store. If 
they decided to collectively purchase an item if either of them 
individually wanted that item, they would be acting under the 
OR logical operator. 


Now, suppose that Steve and Sherry decided that they would 
only purchase an item if they both wanted that item. They would 
then be acting under the AND logical operation. 


Now, suppose that Sherry was angry with Steve. If Sherry 
decided not to purchase the items that Steve wanted, she would 
be acting under the NOT logical operation. The NOT, AND, and 
OR logical operators are summarized in Illustration 3-3. 


A logical operator evaluates an input of one or more operands 
with true or false values. The logical operator evaluates these 
true or false values and returns a value of true or false itself. An 
operand of a logical operator is evaluated as true if it has a 
non-zero value. (Remember, relational operators return a value 
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of +1 for a true value.). An operand of a logical operator is 
evaluated as false if it is equal to zero. 


The result of a logical operation is also a number, which if 
non-zero is considered true, and false if it is zero. 


The following are examples of the use of logical operators in 
combination with relational operators in decision making. 


IF X>10 OR Y<0 THEN 900 
IF A>O AND B>0 THEN 200 
B=-1:PRINT NOT B 


In the first example, the result of the logical operation will be 
true if variable X has a value greater than 10 or if variable Y has a 
value less than 0. Otherwise, it will be false. If the result of the 
logical operation is true, the program will branch to line 900. 
Otherwise, it will continue to the next statement. 


In the second example, the result of the logical operation will be 
true only if the value of both variables A and B are greater than 
zero. If the result of the logical operation is true, program 
control will branch to line 200. Otherwise, program control will 
branch to the next line. 


In the third example, B is set to a value of -1 (true). The value of 
NOT B is then printed. This will be 0 or false. 


Illustration 3-3 contains tables that may prove of help when 
evaluating program statements using logical operators in 
combination with relational operators. 
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Illustration 3-3. Logical Operators 


NOT Operation 





A Operand 

NOT A 

AND Operation 

A Operand 

B Operan¢ 

A AND B 

OR Operator 

A Operand 

B Operand 
T T T AOR B 





APPLESOFT BASIC STATEMENTS 


In the next several sections, we will discuss many of the more 


commonly used statements in Applesoft BASIC. These include 
the following: 


Remark Statements 
Assignment Statements 
Output Statements 

Input Statements 

Loops 

Conditional Statements 
Branching Statements 
Subroutines 

Applesoft BASIC Functions 
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Remark Statements 


Remark statements are used to include a programmer’s 
comments within a program. It is good programming practice to 
include numerous Remark statements in your programs. Not 
only do Remark statements make your programs easier for 
others to understand, they also help you remember your 
program’s logic. 


Remark statements consist of a line number, the reserved word 
REM, and the programmer’s comment. An example of a Remark 
statement is given below. 


100 REM Initialize 1 to 0 


Remark statements are ignored by the Applesoft BASIC inter- 
preter, but are included in program listings. 


In multiple line statements, the REM statement must be the final 
statement. The Applesoft BASIC interpreter ignores all text 
following the keyword REM. 


Assignment Statements 


Assignment statements were discussed briefly earlier in this 
chapter. Assignment statements are used to assign values to 
variables. The following are examples of assignment statements. 


100 =LETA=7 
200 =B=42 

300  NA$= “PHIL” 
400. = -X=1: Y=2:Z=3 


Notice that the keyword LET is optional. Generally, LET is 
assumed. Both string and numeric variables can be assigned 
values with an assignment statement. Also, multiple assignment 
statements can be included in a single line, as long as each of the 
individual statements is separated with a colon. 
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DATA, READ Assignment Statements 


Assigning values to a large number of variables with individual 
assignment statements could prove very cumbersome. The 
DATA, READ statement can be used to assign values to a large 
number of variables. The following is an example of a DATA, 
READ statment. 


100 DATA 100, 500, 1000, “JACK” 
200 READ A,B,C, D$ 


The DATA statement creates a list of constant values known as a 
DATA list. The items in the DATA list are assigned sequentially to 
the variables in the READ statement. A DATA list is depicted tn 
Iustration 3-4. 


DATA statements may contain numeric or string values. These 
values must be separated or delimited with commas. DATA 
statements may appear at any point in the program. No other 
statements can appear in the same program line with a DATA 
statement. 


The DATA list uses a pointer to indicate which value within the 
list is to be assigned to the next variable in a READ statement. 
Before the first READ statement is encountered, the DATA list 
pointer will point to the first value in the DATA list. As values 
from the DATA list are assigned to variables in the READ 
statement, the pointer will move sequentially to each successive 
item in the DATA list. 


The values from the DATA list must match the type of variable to 
which they are assigned in the READ statement. In other words,a 
string value cannot be assigned to a numeric or vice versa. 
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Illustration 3-4. DATA List 


100 DATA 100, 200, 300, 400, 500 


400 DATA MONDAY, TUESDAY, WEDNESDAY, 
THURSDAY, FRIDAY 
500 READA,B,C,D,E DATA List 


600 RESTORE 400,600 —> 
700 READ F,G,H, I, J A F 00 
: +h 






900 READ A$, B$, C$, D$, ES 
r 
500,700 
A$ 





MONDAY 


100 
200 
300 
400 
500 


B$ 






C$ 


400,600 DATA list pointer position 
after the execution of lines 400 and 600. D$ 


500,700 DATA list pointer position 
after the execution of lines 500 and 700. E$ 


900 DATA list pointer position after 
execution of line 900. 


The RESTORE statement is used to reset the DATA list. In 
Illustration 3-4, note the use of the RESTORE statement. After 
DATA list values have been read into A, B, C, D, and Ein line 500, 
a RESTORE statement is executed. This causes the DATA list 
pointer to be reset to the beginning of the DATA list. 
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Outputting Data 


Insome of our preceding examples, we touched upon the use of 
the PRINT statement to display data. The PRINT statement can be 
used to display both numeric and string data. 


The following program statement, 
100 PRINT “VENDOR LIST” 
would display the following at the current cursor position: 
VENDOR LIST 


The first item in a PRINT statement is displayed at the cursor’s 
current location. 


When the Apple Ile is used on the 40 column mode, two or more 
data items could be output to the screen by separating these 
items with commas in the PRINT statement. Upon encountering 
a comma as a delimiter, PRINT will output the next item at the 
next tab stop. In Integer BASIC, tab stops are set at columns 1, 9, 
12, 25, and 33. In Applesoft BASIC, tabs are set at columns 1, 16, 
and 33. 


When the Apple Ile is used in the 80-column mode, only two 
tab stops are present. In Integer BASIC, the tab stops are located 
at columns 1 and 9. In Applesoft, they are located at columns 1 
and 17. 


The following examples illustrate the use of the comma with 
PRINT in the 40 and 80 column modes. 


Integer 40 Column 
> PRINT 1,2,3,4,5,6 
12 3 4 ~°5 
6 


Applesoft - 40 Column 
] PRINT 1,2,3,4,5,6 
1 2 3 
4 5 6 
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*Integer 80 Column 
=> PRINT 1,2,3,4,5,6 
1 6 


*Applesoft - 80 Column 
] PRINT 1,2,3,4,5,6 
1 6 


A semicolon can also be used to separate the items in a PRINT 
statement. A semicolon causes the next item in the PRINT 
statement to be displayed immediately after the preceding item. 
Unlike the use of the comma in a PRINT statement, when 
semicolons are used to separate items, no blank spaces appear 
between string or numeric values. 


When a PRINT statement has finished execution, the cursor 
moves to the left margin of the following line. This is known as a 
carriage return/line feed. 


Ifa comma or semicolon occurs at the end of a PRINT statement, 
the carriage return/line feed will be suppressed. If a comma is 
placed at the end of the PRINT statement, the next PRINT 
statement will begin output at the next print zone after the last 
item is displayed. If asemicolon is placed at the end of the PRINT 
Statement, the next PRINT statement will begin output 
immediately following the last item displayed. 


In this section, we have only discussed sending output to the 
video display. Output can also be sent to the printer. This is 
accomplished by executing the PR# statement prior to PRINT. 


The usage of PR# to send data to the printer is discussed in 
Appendix H. 


*In the 80 column mode, each comma causes the subsequent 
value to be displayed in the second tab position. In our 
examples, 2,3,4,5, and finally 6 were successively displayed in 
the second tab position. 
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INPUT Statements 


Data can be input into the computer while a program is being 
executed. This is accomplished with the INPUT statement. 
For example, when the following statement is executed: 


100 INPUT A 


the computer will display a question mark and wait for the 
operator to enter a response. That entry will be assigned to the 
variable A. The entry must be ended by pressing the Enter key. 
Program execution will then resume. 


The values of several numeric variables can be input with a single 
INPUT statement as shown in the example below. 


200 INPUT X, Y, Z 


When the preceding INPUT statement is executed, the INPUT 
prompt (?) willl be displayed. The operator should then enter the 
data items for X, Y, and Z. Each input should be separated by a 
comma. The Return key should be pressed after all input entries 
have been made. An example of a valid entry for the preceding 
INPUT statement is given below. 


100, 200, 300 [Ret]* 


Caution should be used when inputting string data. Be certain 
that your string entries do not contain a comma unless enclosed 
in quotation marks. A comma will be interpreted by Applesoft 
BASIC asa delimiter. Any data appearing after the comma will be 
treated as a separate INPUT statement data item. 











* [Ret] indicates pressing the Return Key. 
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GET 


Applesoft’s GET statement allows a single character to be input 
via the keyboard. That character is not displayed on the screen. 
Also, the return key need not be pressed after the entry has been 
made. The following program illustrates the usage of GET. 


70 PRINT “IF YOU WISH TO STOP—ENTER Y”’ 
90 PRINT “OTHERWISE, PRESS ANY KEY” 

100 GET Z$ 

130 IF Z$=“Y” GOTO 950 

140 PRINT Z$ 

150 GOTO 70 

950 PRINT “PROGRAM ENDS” 

999 END 


If a string variable is used with GET, the character entered will be 
treated as a string value. If a numeric variable is used with GET, 
the character entered must be a number. If a non-numeric 
character is entered, the SYNTAX ERROR message will appear 
and the program will end. 


FOR, NEXT Loops 


Suppose that you needed to compute the squares of the integers 
from 1 to 20. One way of doing this is by calculating the square 
for each individual integer as shown below. 


100 A=1A2 
200 PRINT A 
300 B=2A2 
400 PRINT B 
500 C=3A2 
600 PRINT C 
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However, this method is very cumbersome. This problem could 
be solved much more efficiently through the use of aFOR, NEXT 
loop as shown below. 


100 FOR A=1TO 20 


200 X=AA42 
300 PRINT X 
400 NEXTA 
500 END 


The sequence of statements from 100 to 400 is known as a loop. 
When the computer encounters the FOR statement in line 100, 
the variable A is set to 1. X is then calculated and displayed in 
lines 200 and 300. 


The NEXT statement in line 400 will request the next value for A. 
Execution returns to line 100 where the value of A is incremented 
by 1 (to 2) and then compared to the value appearing after TO. 
Since the value of A is less than that value, the loop will be 
executed again with the value of A set at 2. 


The loop will continue to be executed until A attains a value 
greater than 20. When this occurs, the statement following the 
NEXT statement will be executed. 


In our preceding example, A is known as an index variable. If the 
optional keyword STEP is not included with the FOR statement, 
the index variable will be incremented by 1 every time the NEXT 
statement is executed. 


STEP can be included at the end of a FOR statement to change 
the value by which the index variable is incremented. The 
integer appearing after STEP is the new increment. For example, 
if our preceding example were changed as follows, 


100 FOR A=1 TO 20 STEP 2 


200 X=AA2 
300 PRINT X 
400 NEXTA 


500 END 
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the index variable A would be incremented by 2 every time the 
NEXT statement was executed. 


Nested Loops 


One loop can be placed inside another loop. The innermost 
loop is known as a nested loop. The following program contains 
a nested loop. 


50 DIMR (2,3) 

100 DATA 10, 20, 30, 40, 50, 60 
200 FOR!=1TO2 

300 FORJ=1TO3 

400 READ R (I,J) 

450 PRINTR (I,J) 

500 NEXT} 

600 NEXT! 


Our preceding example is used to read data into the numeric 
array R. 


One error that you should take care to avoid when using nested 
loops is to end an outer loop before an inner loop is ended. 


Conditional Statements 


One of the most important features of a computer is its ability to 
make a decision. BASIC uses the IF, THEN statement to take 
advantage of the computer’s decision making ability. The IF, 
THEN statement takes the following form: 


IF expression THEN statement or line number 


The IF statement sets up a question or a condition. If the answer 
to that question is true, the statement or line number following 
THEN is executed. If the answer is false, all instructions following 
THEN are ignored, and program execution will resume with the 
next line number in the program. 


In the following example, if 1 is input for X, the Y is set equal to 1. 
Otherwise, Y’s value remains 0. 
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20 INPUT X 

50 Y=0 

100 IF X=1THEN Y=1 
200 PRINT X: PRINT Y 


Branching Statements 


Branching statements change the execution pattern of programs 
from their usual line by line execution in ascending line number 
order. A branching statement allows program control to be 
altered to any line number desired. The most commonly used 
branching statements in BASIC are GOTO and GOSUB. 


GOTO takes the following format: 
GOTO line number 
For example, the following program statement, 


500 GOTO 999 


999 END 
would branch program control at line 500 to line 999. 


Branching statements are often used in conjunction with con- 
ditional statements. In such a situation, the normal execution of 
the program is altered depending upon the outcome of the 
condition set up in the IF statement. This is shown in the 
following example. 


100 INPUT “ENTER THE AMOUNT ”;A 
200 IF A=0 THEN GOTO 900 

300 PRINT A 

400 GOTO 100 

900 INPUT “FINISHED ’;B$ 

910 IF BS =“°N” THEN 100 

999 END 
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In our preceding example, if the value input for A has a zero 
value, then the program will branch to line 900 where the 
operator will be prompted whether he has finished entering 
data. In line 910, the program will set up a condition where if the 
input was ‘N’, the program will branch to line 100. If the entry was 
not equal to ‘N’, the program will continue to line 999 where it 
will end. 


Note in line 910 that a GOTO statement is not used to precede 
the line number being branched to. When a line number is 
indicated following a THEN statement, the computer does not 
require the presence of GOTO, which is assumed. 


ON, GOTO Statement 


The ON, GOTO statement is a combination of a conditional 
statement and a branching statement. The use of the ON, GOTO 
statement is illustrated in the following program. 


10 INPUTA 

20 ONA GOTO 40, 50 

30 GOTO 99 

40 PRINT “A=1": GOTO 99 
50 PRINT “A= 2” 

99 END 


If the variable or expression following ON evaluates to 1, 
program control branches to the first line number specified after 
GOTO; if 2, to the second; if 3, to the third, etc. 


If the variable or expression evaluates to a number greater than 
the number of line numbers following GOTO, program control 
will branch to the statement immediately following the ON, 
GOTO statement. This is also the case if the variable or 
expression following ON evaluates to zero. 


Subroutines & GOSUB Statements 
Many times you will find that the same set of program instructions 


are used more than once in a program. Re-entering these 
instructions throughout the program can be very time con- 
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suming. By using subroutines, these additional entries will be 
unnecessary. 


A subroutine can be defined as a program which appears within 
another larger program. The subroutine may be executed as 
many times as desired. 


The execution of subroutines is controlled by the GOSUB and 
RETURN statements. The format for the GOSUB statement is as 
follows. 


GOSUB line number 


The computer will begin execution of the subroutine beginning 
at the line number indicated. Statements will continue to be 
executed in order, until a RETURN statement is encountered. 
Upon execution of the RETURN statement, the computer will 
branch out of the subroutine back to the first line following the 
original GOSUB statement. This is illustrated in the following 
example. 


illustration 4-5. BASIC Program With a Subroutine 


10 INPUT“PAY TO THE ORDER OF ”:A$ 

20 INPUT “CHECK AMOUNT”: X 

30 IF X =0 THEN 200 

40 IF X << 0 THEN GOSUB 100 

50 IF X > 1000 THEN GOSUB 100 

60 IF (X >0) AND (X < 1000) THEN PRINT A$,X 

70 GOTO 10 

100 PRINT “NOT VALID AMOUNT” 
Subroutine (110 INPUT “TRY AGAIN ”:X 

120 RETURN 

200 END 


Subroutines can help the programmer organize his program 
more efficiently. Subroutines also can make writing a program 
easier. By dividing a lengthy program into a number of smaller 
subroutines, the complexity of the program will be reduced. 
Individual subroutines are smaller and therefore more easily 
written. Subroutines are also more easily debugged than a 
longer program. 


Applesoft BASIC Programming 75 


ON, GOSUB Statement 


The ON, GOSUB statement is very similar in nature to the ON, 
GOTO statement. The following statement is an example of an 
ON, GOSUB statement. 


100 ON X GOSUB 1000, 2000, 3000 


If the value of X is 1, the subroutine at line 1000 is executed. If X is 
2, the subroutine at line 2000 is executed. If X is 3, the subroutine 
at line 3000 is executed. If X evaluates to 0 or to anumber greater 
than 3, the statement immediately following the ON, GOSUB 
statement will be executed. 


If ON, GOSUB causes a branch toa subroutine, program control 
will revert to the line immediately following the ON, GOSUB 
statement, once the subroutine has been executed. 


Applesoft BASIC Functions 


Functions are used in Applesoft BASIC to perform predefined 
calculations or operations on their arguments. All functions use 
the following format. 


function (argument) 
function is the keyword for the function. argument is a variable, 
constant, or expression which is to be stored in the operation 


defined by the function. 


The following statement is an example of the use of the SQR 
function. 


100 A = SQR(49) 
In this example, A would evaluate at 7. SQR is the keyword which 
describes the square root function. The square root of 49 is, of 


course, equal to 7. 


Functions can be used with arithmetic, relational, and Boolean 
expressions, as shown in the following statement. 
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100 X = 100-7 * SQR(49) 


In an expression containing functions as well as arithmetic, 
relational, and/or Boolean operators, the function’s value is 
calculated first. In our preceding example, the square root of 49 
would be calculated, that value would be multiplied by 7, and 
the product subtracted from 100. 


Applesoft BASIC also includes a number of functions for 
performing operations on strings. These include: 


LEFT$ 
MID$ 
RIGHT$ 


These functions can be used to extract one or more characters 
from a String. 


The various Applesoft BASIC functions are described in Chapter 
4, 


String Concatenation 

The addition operator (+) can be used to join together or 
concatenate two strings. When concatenating strings, re- 
member that the maximum length of a string in Applesoft BASIC 
is 255 characters. 


The following program illustrates string concatenation. 


100 A$= “JOHN” 


200 B$= “BILL” 
300 C$=A$+ BS 
400 PRINT C$ 
500 END 

RUN 

JOHNBILL 


The subtraction operator (-) cannot be used to separate a 
portion of a string. 
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ASCIl 


The tle cannot store characters; it can only store numbers. 
Before characters can be stored, they must be converted to 
numbers. Computers use special numeric codes to store char- 
acters. Most microcomputers use a code known as ASCII 
(American Standard Code for Information Interchange). 


The codes used by the Ile are listed in AppendixG. These codes 
can be activated by including them with the CHR$ function with 
a PRINT statement. For example, the following: 


PRINT CHR$(56) 
would cause the number 8 to be output on the display. 
CHR$ & ASC Functions 


As mentioned earlier, characters are represented with ASCII 
codes. Applesoft BASIC’s CHR$ function can be used to translate 
an ASCII code to its equivalent character. The following short 
program illustrates the use of the CHR$ function. 


100 PRINT CHR$(54) 
200 PRINT CHR$(55) 
300 END 

RUN 

6 

7 


The CHR$§$ function is often used to represent characters in a 
statement, when that character can not be represented in its text 
form. For example, in the following program, 


100 PRINT CHR$(34); “JOHN JOHNSON”; CHR$(34) 
200 END 

RUN 

“JOHN JOHNSON” 


quotation marks are specified in the PRINT statement using their 
ASCII code and the CHR$ function. 


78 Apple Ile Users Handbook 


The ASC function returns the ASCII code equivalent for its string 
argument. If this string is longer than one character, the ASC 
function returns the ASCH code for just the first character in the 
string. 


The following program illustrates the use of the ASC function: 


100 A$= “JOHN JOHNSON” 
200 PRINT ASC(A$) 

300 END 

RUN 
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PEEK AND POKE 


The PEEK and POKE statements allow direct access to the Ile’s 
memory. The argument of PEEK and POKE indicates the address 
in memory to be accessed. Every memory location can store a 
number in the range 0 through 255. 


The PEEK function allows the user to examine the value stored in 
the memory location named as its argument. For example, in the 
following statement. 


100 N = PEEK (1000) 


the value stored at memory location 1000 will be assigned to the 
variable N. 


The POKE statement is used to place a value in a specified 
memory location. POKE uses the following configuration, 


POKE address, value 
where the value specified is placed in the location given in 
address. value and address can either be constants or variables. 
For example, in the following statement, 


100 POKE 2000, X 


the value stored in variable X will be POKE’d into memory 
location 2000. 
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STOPPING PROGRAM EXECUTION 


A number of different methods are available for stopping 
program execution on the Ile. These will be discussed in the 
following sections. 


Control-C 


A program can be stopped by pressing the Control and C keys 
simultaneously. If Control-C is pressed in response to an INPUT 
statement prompt, the Return key must be pressed after 
Control-C to stop execution. 


When program execution is stopped by pressing Ctrl-C, the 
following message will be displayed (in Applesoft BASIC): 


BREAK IN line number 


The line number will be the line number where the program 
execution was stopped. Program execution can be resumed by 
entering CONT. 


In Integer BASIC, the following message will be displayed when 
program execution is stopped using Ctrl-C. 


STOPPED AT line number 


Again, line number indicates the line where program execution 
was stopped. Program execution can be resumed by typing tn 
CON. 


END 


The END statement can be used to stop program execution. 
Progam execution can be resumed once END has been executed 
by entering CONT. In Integer BASIC, program execution cannot 
be resumed once END has been executed. 
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STOP 
When a STOP statement is executed in Applesoft BASIC, 
program execution is halted, and the following message is 
displayed. 

BREAK IN line number 
Program execution can be resumed by entering CONT. 


RESET 


Pressing CONTROL-RESET will also stop execution of a program. 


CHAPTER 4. 
APPLE BASIC REFERENCE GUIDE 


INTRODUCTION 
In this chapter, we will provide descriptions of the various 
commands, statements, and functions used in Applesoft and 
Integer BASIC. 
The following rules and abbreviations will be followed in this 
chapter in our configuration descriptions of the various BASIC 
commands, statements, and functions. 
1. Any capitalized words are keywords. 
2. Any words, phrases, or letters shown in lowercase italics 
identify an entry that must be made by the operator (unless 
enclosed within brackets). 


3. Any items enclosed in brackets [ ] are optional. 


4. Anellipsis (...) shows that an item may be repeated as often 
as desired. 


5. Any punctuation marks, except the square brackets (ex. ; , 
=) must be included where they are shown. 


* Except [Ret]. 
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# Applesoft 
ABS mw Integer 


The ABS function returns the absolute value of the argument. A 
number’s absolute value is its value without regard to sign. 


Configuration 
ABS(argument) 


The argument can be any numeric expression or numeric 
constant. In Integer BASIC, the numeric constant must be an 
integer. 


Example 


10 A = ABS(-1 * 7) 

20 PRINT A, ABS(2.99) 
JRUN [Ret] 

7 2.99 


In the preceding example, the absolute values of -7 and 2.99 are 
returned. 


# Applesoft 
AND m Integer 


AND is a logical math operator. This reserved word is generally 
used to compare two numeric expressions in the context of an IF, 
THEN statement. 


Configuration 
expression? AND expression2 
expression? and expression2 are Boolean expressions. If an 


expression was numeric (not zero), that expression would 
evaluate as true. For example, if an expression evaluated to 5, 
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AND would treat it as true. The following is the truth table for 
AND. 


X Y X AND Y 
true true true 
true false false 
false true false 
false false false 


In both Applesoft and Integer BASIC, a true is represented by a1 
and false by a 0. 


Example 1 


10 A=2 

20 B=3 

30 IF (A = 2) AND (B = 3) THEN 60 

40 PRINT “AND FAILED LOGICAL TEST” 
50 GOTO 70 

60 PRINT "AND PASSED LOGICAL TEST” 
70 END 

JRUN [Ret] 

AND PASSED LOGICAL TEST 


In the preceding example, line 30 first tested the value of A. Since 
A was set equal to 2in line 10, the first expression was evaluated 
as true. The value of B was then tested. It too evaluated as true. 
Using the logical AND table, if expression? and expression2 
evaluated to true, then the whole AND expression evaluated as 
true. The program will then execute the THEN portion of the 
statement and will branch to line 60. At line 60, the message AND 
PASSED LOGICAL TEST was displayed. 


Example 2 


PRINT (3 = 1+ 2) AND (-5) 
1 


In this example, 3 is set equal to 1 + 2, so the first expression 
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evaluates as true. The second expression (-5) is non-zero, So it Is 
also evaluated as true. According to the AND truth table, if both 
expressions evaluate as true, then the whole expression is true. 
Applesoft and Integer BASIC represent true as 1, so a 1 is printed. 


#® Applesoft 
ASC @ Integer 





The ASC function returns the ASCII code for the first character in 
its argument. 


Configuration 
ASC(argument) 
argument can be any string variable or constant. 
Example 
JA$ = "A" 


JPRINT ASC(A$), ASC(”DEF”) 
65 68 


In the preceding example, the character in the string A$ was A. 
A’s ASCII equivalent is 65. In the second string, the first character 
D will be used as the argument. A value of 68 is returned for the 
ASCII value of D. 


#8 Applesoft 
ATN O Integer 





The ATN function is a trigonometric function that returns the 
arctangent of its argument. 
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Configuration 
ATN(argument) 


The argument can be anumeric expression or numeric constant 
in radians. The value returned will be the primary angle 
ie 1 


( 5 < angle <5) 


Example 


10 Pl =ATN(1) * 4 

20 PRINT PI, ATN(TAN(.2)) 

JRUN [Ret] 

3.14159266 2 


In the preceding example, the arctangent of 1 returns the value 
7/4, Multiplying this value by 4 returns the value indicated. 


In the second part of the PRINT statement, the argument .2 is 
returned. Since the ATN formula is the inverse of the TAN 
function, the value returned was the original argument. 


O Applesoft 
AUTO w Integer 


The AUTO command generates a new line number every time 
the user presses Return. 


Configuration 
AUTO line number [,increment] 


Both linenumber and increment must be integers. The fine- 
number will be the first line number generated. The increment is 
the amount to be added to the current line number to generate 
the next line number. If the increment is not included, the 
increment will be set to 10 by default. 
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The AUTO command is generally used when entering programs. 
This saves the user the task of typing every line number. 


The AUTO command is ended by pressing Ctrl-X and typing 
MAN. 


Example 


AUTO 30 
AUTO 10, 5 


The first command will generate the line numbers 30, 40, 50, and 
so on. The second command will generate the line numbers 10, 
15, 20, 25, 30, ... 

AUTO is not available in Applesoft BASIC. 


= Applesoft 
CALL m Integer 





The CALL statement is used to execute a machine language 
subroutine. 


Configuration 
CALL expression 
expression evaluates to an integer between -65535 and +65535. 
In Integer BASIC, the value of the expression must be an integer 


between -32767 and +32767. 


The expression is the location of the machine language sub- 
routine, 


In Applesoft, there are two values which will execute the same 
machine language subroutine. There is the positive address and 


the negative address. The conversion is as follows: 


positive address — 65536 = negative address 
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This can be very useful in Integer BASIC. If there was a machine 
language subroutine located at location 64578, a CALL 64578 
could not be used. This is due to the fact that the expression 
indicated is greater than the largest integer that can be used in 
Integer BASIC. Using the previous conversion equation, the 
CALL used would be CALL-958. 


Example 
CALL-936 
The preceding CALL executes a machine language subroutine at 


the given location. This CALL is identical to the HOME command 
in Applesoft. 


@ Applesoft 
CHR$ D Integer 





The CHR$ function returns the ASCII character for the value 
given in the argument. 


Configuration 
CHR$(argument) 


argument is areal number or an integer between 0 and 255. If the 
argument is areal number, its decimal portion will be truncated. 


Example 
10 X$ = CHR$(80) 
20 PRINT CHR$(65), X$ 


JRUN [Ret] 
A P 


The ASCII code for A is 65 and the code for P is 80. 
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@® Applesoft 
CLEAR O Integer 


CLEAR initializes all variables, arrays, and strings to zero. CLEAR 
also initializes all DATA pointers, FOR...NEXT counters, sub- 
routine pointers, etc. 


Configuration 
CLEAR 


CLEAR can be used anywhere in a program, but should not be 
used in a subroutine or FOR...NEXT loep. 


Example 


10 A=10 
20 PRINT A 
30 CLEAR 
40 PRINT A 
JRUN [Ret] 
10 

0 


Line 30 sets variable A from 10 to 0. 


O Applesoft 
CLR m Integer 





CLR sets all variables to 0, strings to null, and clears any 
dimensioned variables. 


Configuration 
CLR 


CLR can only be used in the immediate mode. 
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Example 


A =10 

Bg = "P” 
CLR 

PRINT A, B$ 
0 


The variable A is cleared to 0 and the string variable B$ is set to 
null. 


8 Applesoft 
COLOR @ Integer 





The COLOR statement defines the next color to be displayed by 
the graphics statements PLOT, HLIN...AT, and VLIN...AT. 


Configuration 
COLOR = expression 
The expression is an integer from 0 to 255. The computer can 


display a total of 16 different colors. The colors and their 
associated numbers are shown below. 


0 Black 8 Brown 
1 Magenta 9 Orange 
2 Dark Blue 10 Grey 

3 Purple 11 Pink 

4 Dark Green 12 Green 
5 Grey 13 Yellow 
6 Medium Blue 14 Aqua 

7 Light Blue 15 White 


Beyond 15, the colors repeat (16 - Black, 17 - Magenta). 
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Example 


10 GR 

20 COLOR = 6 
30 PLOT 0,0 
40 END 


The preceding program will place a blue square in the upper left 
hand corner of the screen. 


O Applesoft 
CON m Integer 


The CON statement resumes program execution at the next 
Instruction. 


Configuration 


CON 


This command ts generally executed following a Ctrl-C. 
Example 


10 FOR X =1TO 10 
20 PRINT X, XA2, XA3 


30 NEXT X 

40 END 

> RUN [Ret] 

1 1 1 

2 4 8 

4 16 64 

5 25 125 
Ctrl-C pressed — eT OppED AT 30 

> CON [Ret] 

6 36 216 

7 49 343 

8 64 512 

9 81 729 

10 100 1000 
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In the preceding example, a Ctrl-C was entered in as shown. The 
Ctrl-C stopped the execution of the program. Entering in CON 
continued program execution. 


# Applesoft 
CONT O Integer 


CONT resumes program execution at the next instruction. 
Configuration 
CONT 


This command is generally executed following a STOP, END, or 
Ctrl-C. 


Example 


10 FORI=1TO5 

20 PRINT 1, 1A2 

30 IF |=3 THEN STOP 
40 NEXT | 

JRUN [Ret] 

1 1 

2 

3 9 


BREAK IN 30 
JCONT [Ret] 
4 16 
5 25 


In the preceding example, program execution stopped in line 30 
when | = 3. Typing in CONT continued program execution. 
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= Applesoft 
COS O Integer 





The COS function is a trigonometric function that returns the 
cosine of its argument. 


Configuration 
COS(argument) 


The argument is a numeric expression or numeric constant in 
radians. 


Example 


JPRINT COS(3.141592653) 
i 


In the preceding example, the cosine of Pl is returned. 


# Applesoft 
DATA O Integer 


The DATA statement contains a list of data items. These data 
items are read into the variables specified by the READ state- 
ment. 


Configuration 
DATA item [,item...] 
item can either be a real number, integer, or string. The data 
items must be in the same order as they are read by the READ 


Statement. 


If a comma or colon is to be included in the string, the item 
should be enclosed in quotes. The following characters cannot 
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be placed in a DATA statement. 


RETURN Ctrl-H 

ESC Ctrl-M 

. Ctrl-U 

(left arrow) Ctrl-X 
(right arrow) 


The preceding characters may be used in a program by 
executing the CHR$ function. 


The DATA statement can be located anywhere in a program. It 
does not have to precede the READ statement. 


Example 


10 DATA “SMITH, JOE”, JOHN BROWN 
20 READ N1$, N2$ 

30 PRINT N1$, N2$ 

JRUN [Ret] 

SMITH, JOE JOHN BROWN 


The READ interpreted the first string as SMITH, JOE because it 
was enclosed in quotes. The second string is read as JOHN 
BROWN. 


® Applesoft 
DEF FN O Integer 


The DEF FN statement allows the user to define a function. This 
function can then be used in the same manner as any built-in 
function. 


Configuration 


DEF FN name (variable) = expression 
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name is the name of the function. Like variable names, only the 
first two characters are significant. The variable can be any real 
numeric variable name. The expression can be a numeric 
constant or a numeric equation. 


Example 


10 Pl = ATN(1) *4:REM PI 
20 DEF FNAR(X) = PI * XA2 
30 FOR RAD =1T0 3 

40 PRINT RAD, FNAR(RAD) 


50 NEXT RAD 

60 END 

JRUN [Ret] 

1 3.14159266 
2 12.5663706 
3 28.2743339 


In line 10, Pl is calculated so it can be used in the function 
definition. In line 20, the function for the area of a circle is 
defined. Line 40 then uses the function by passing the value of 
the radius to the function. The value of the area of the circle ts 
then returned and printed by the PRINT statement. 


8 Applesoft 
DEL w Integer 


DEL deletes the lines given in the argument. 
Configuration 
DEL a [,b]* 


a and b are integers greater than or equal to 0. In Applesoft, b 
must be greater than a. In Integer BASIC, if bis less than a only 


* The [,b] is only optional in Integer BASIC. 
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line a will be deleted. 


If a is not an existing line number in the program, the next 
highest line number will be used. If b is not an existing line 
number in the program, the next lowest line number will be 
used. 


The DEL can also be used as a program statement in Applesoft. If 
the DEL is used as a program statement, the specified lines will be 
deleted. However, program execution will halt after the 
statement has been executed. The CONT command will not 
resume program execution. 


Example 


JLIST [Ret] 

10 TEXT 

20 CALL-936:REM HOME 
30 VTAB 3 

40 PRINT “HELLO” 

50 END 

]DEL 30,50 [Ret] 

JLIST [Ret] 

10 TEXT 

20 CALL -936:REM HOME 


® Applesoft 
DIM @ Integer 


The DIM statement is used to allocate memory space for strings, 
arrays, or matrices. 


Configuration 


Applesoft a (ij...) Lb (iLy].--] 
DIM a% (iLj)...) L6% (iL/]---] 
a$ (a$ (iL,/]-.-) LO$ (iL/].-] 
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Integer 


pi 2 LB 


a$ (i[,b$(i)...] 


a and bare the variables to be dimensioned. i and j are integers. 
In Integer BASIC, the string variable must be dimensioned with 
255 elements or less. 


In Applesoft BASIC, all arrays, strings, and matrices are prede- 
fined with subscripts of 10. Above 10, the value in a DIM 
statement corresponds to the largest subscript that can be used 
in that variable. However, there is always a zero subscript. As a 
result, to save 100 values in a single dimension array, the correct 
DIM statement would be DIM A(99). 


In Integer BASIC, the value in a DIM statement corresponds to 
the largest subscript that can be used with that variable. An 
Integer variable with a subscript of 0 is the same as a variable 
without the subscript. If TEST(0) = 27, then TEST is also equal to 27 
and vice versa. With string variables, there is no 0 subscript. 


The maximum size of strings and arrays depends on the amount 
of available memory at the time the DIM statement was 


executed. 


If the DIM statement exceeds the amount of available memory, 
the following error will occur: 


Appiesoft BASIC ?OUT OF MEMORY ERROR IN fine 


Integer BASIC ***MEM FULL ERR 
STOPPED AT fine 


where line is the line of the DIM statement. 


Example -- Applesoft 
DIM A$(10,5), C%(2,20) 


In the preceding example, 66 string spaces are allocated for A$, 
and 63 integer variables are defined for C%. 
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Example -- Integer BASIC 
DIM A(10), N$(5) 


In the previous example, the DIM statement defines 10 spaces 
for the variable A, and N$(5) defines one string of length 5. 


# Applesoft 
DRAW O Integer 


The DRAW statement plots a shape on the high-resolution 
graphics page. 


Configuration 
DRAW shapeno [AT X, Y] 


shapeno is an integer between 0 and 255. X and Y are integers for 
the position of the shape. X must lie between 0 and 279. Y must lie 
between 0 and 191. 


If AT X, Yis not given, the shape will be plotted at the last X, Y 
position designated. 


The color, rotation, and size of the shape must have been 
previously defined. 


Example 


10 REM SET UP SCREEN 

20 TEXT:HGR 

30 FOR X = 7936 TO 7946 

40 READ V:REM READ IN SHAPE 

50 POKE X,V:REM POKE SHAPE INTO TABLE 
60 NEXT X 

70 REM TELL WHERE SHAPE IS AT 

80 POKE 232,0:POKE 233,31 

90 HCOLOR =3 


program continued on the next page 
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100 ROT =0 

110 SCALE = 10 

120 DRAW 1 AT 50,30 

130 HPLOT 20,70 

140 SCALE =6 

150 ROT =4 

160 DRAW 1 

170 DATA 1,0,4,0,39,36,45,53,54,63,0 
180 END 


In the preceding example, line 20 initialized the screen for high 
resolution graphics. The shape table is then read in the FOR 
NEXT loop in lines 30 to 60. These lines define the shape. Since 
Applesoft needs to know where the shape table was placed, the 
shape address is poked into memory in line 80. Lines 90, 100, and 
110 then define the color, rotation, and size of the shape drawn 
at line 120. The shape drawn in line 160 will have the position 
defined at line 130, size in 140 and the rotation in 150. 


O Applesoft 
DSP w Integer 





The DSP command is a debugging tool. It displays the variable’s 
value each time its value is changed. 


Configuration 
DSP variable 
variable is a variable in the program to be traced. 


The DSP command will display the variable, the variable’s value, 
and line number each time its value is changed. 
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Example 


10 DSPA 
20 DSP B 
30 A=1 
40 B=7 
50 C=A*B 
60 B=C+t+A 
70 END 
IRUN [Ret] 
#30 A=1 
#40 B=7 
#60 B=8 


In the preceding example, the line number, variable, and 
variable values are displayed when the indicated variable’s 
values change. Notice that in line 50 the value of A and Bis used, 
but not changed, so it is not displayed. 


# Applesoft 
END m Integer 





The END statement is used to stop program execution. 
Configuration 
END 


The END statement is optional in Applesoft. If it is not used, the 
program will stop execution at the highest line number. 


The END statement is optional in Integer BASIC, but if it is not 
included a NO END error will result. The program will essentially 
run the same with or without the END statement. 


Example 


999 END 


100 Apple Ile Users Handbook 


mw Applesoft 
EXP O Integer 





The EXP function returns the value of e raised to the power of the 
argument. 


Configuration 
EXP (argument) 


argument is a numeric constant or numeric expression. (e = 
2.71828183). 


Example 


PRINT EXP(5) 
148.413159 


In the preceding example, e° was returned. 


# Applesoft 
FLASH O Integer 


The FLASH statement turns on the FLASH video. Following the 
execution of the FLASH statement, any characters displayed by 
the computer will flash. The characters will alternate from black 
on white to white on black. 


Configuration 
FLASH 


Any characters echoed by the computer (entered through the 
keyboard), will not flash. 


The FLASH mode works by altering the standard ASCII code. So, 
any characters sent to the disk or printer while the FLASH mode 
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is on, may be sent with the incorrect codes. 


The FLASH statement is equivalent to a POKE 50,127. The FLASH 
statement is turned off by the NORMAL statement. 


Example 


] FLASH 
] PRINT “**” 


* ok 
When the lle’s 80-column card is activated (either in the 40 or 80 
column mode), the alternative character set will be active. The 


alternate does not include flashing characters. Therefore, FLASH 
does not function properly when the 80 column card is active. 


# Applesoft 
FOR..NEXT w Integer 





The FOR..NEXT statements are used to execute a sequence of 
statements a set number of times. 


Configuration 


FOR variable =a to b [STEP c] 


NEXT [variable*] [,variable ...] 


variable is a real variable in Applesoft. The variable is used as a 
counter. a, b and c are numeric expressions or constants. The 
numeric constant must be an integer in Integer BASIC. a is the 
initial value of the counter and bis the final value. The counter is 
incremented or decremented depending on the sign of c. If c is 
not given, it will be assumed as 1. 


* The variable in NEXT is only optional in Applesoft. 
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The program lines following the FOR statement will be executed 
until the NEXT statement is encountered. At this point, the 
counter is incremented (assuming positive STEP value) by the 
STEP value. 


The value for the counter is then compared with its final value b. 
As long as the counter’s value does not exceed the final value, 
the program will branch back to the statement following the 
FOR statement. This entire process will then be repeated. 


When the counter’s value exceeds the specified final value (5), 
the statement following the NEXT statement will be executed. 
This will exit the FOR..NEXT loop. 


One FOR..NEXT loop may be placed within another FOR..NEXT 
loop. This is known as nesting or nested loops. When FOR..NEXT 
loops are nested, each FOR..NEXT loop must use a different 
variable name for the counter. Also, the NEXT statement for the 
inside loop must appear before the NEXT statement for the 
outside loop. However, if both loops end at the same point, a 
single NEXT statement may be used to end these. Be certain that 
the variable for the inside loop appears before the variable for 
the outside loop. A NEXT statement such as the following: 


NEXT J,1 
would be interpreted as follows: 


NEXT J 
NEXT | 


Example 


10 FOR X =1 TO -2 STEP -1 
20 PRINT X 

30 NEXT X 

40 END 

JRUN [Ret] 
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In the preceding example, the STEP value is -1 so the counter is 
decremented until its value is -2. 


m@ Applesoft 
FRE O Integer 





The FRE function returns the number of free bytes in memory. 
Configuration 
FRE (argument) 


argument can be any legal expression. It makes no difference 
what the argument is. 


If the amount of free bytes exceeds 32767, the FRE function will 
return a negative number. By adding 65536 to this number, you 
can compute the actual number of free bytes. 


When FRE is used, a housekeeping will be performed before the 
function returns the number of free bytes. Housekeeping is a 
process where BASIC gathers all useful data by freeing any 
memory which was once used for strings, but which is currently 
unused. Memory for strings becomes unused when the string’s 
length changes. 


Example 


10 A =FRE (0) 

20 IF A <0 THEN A = A+65536 

30 PRINT “NUMBER OF FREE BYTES IS”;A 
40 END 

JRUN [Ret] 

NUMBER OF FREE BYTES IS 36272 
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# Applesoft 
GET 0 Integer 


The GET statement inputs a single character from the keyboard. 
The character is not displayed on the screen. 


Configuration 
GET variable 
variable can be any legal Applesoft variable. 


Although variable can be any variable, it is to the user’s 
advantage to use a string variable and convert it to a numeric 
variable with the VAL function. If a numeric variable was used 
with GET, any non-numeric character entered will cause a syntax 
error and halt program execution. 


Example 


10 PRINT “PRESS A KEY”; 

20 GET A$ 

30 PRINT 

40 PRINT “THE KEY PRESSED WAS"; A$ 

50 PRINT 

60 PRINT “IF THE KEY PRESSED WAS NOT A DISPLAYABLE 
CHARACTER IT WOULD NOT BE DISPLAYED” 

70 END 


In the preceding example, line 10 prompts the user to press a 
key. Line 20 waits for a key to be pressed. When a key is pressed, 
the character value of the key is assigned to the variable A$. Line 
40 then displays the character input. Line 60 is included because 
some keys generate characters that cannot be displayed (i.e. 
return key, ESC key and the space bar). 


Apple BASIC Reference Guide 105 


# Applesoft 
GOSUB, RETURN w Integer 


The GOSUB, RETURN statements are used to branch to a 
subroutine and then return from it. 


Configuration 


GOSUB line 


RETURN 


line is the first line of asubroutine. In Applesoft, the GOSUB will 
branch to line 0 if line is omitted or an expression is used. In 
Integer BASIC, line can be an expression, where the expression 
evaluates to a line number of a subroutine. 


A subroutine is called by the GOSUB statement. When the 
RETURN statement is encountered within that subroutine, 
program control will branch back to the statement following the 
GOSUB statement just executed. 


Subroutines may appear at any point within the program. 
However, it is good programming practice to group all sub- 
routines near the beginning of the program. 


Example 


10 GOTO 60 

20 PRINT X, 

30 Y =X*X 

40 PRINT Y 

50 RETURN 

60 X =0 

70 FOR I=17TO 3 
80 X = X+1 

90 GOSUB 20 


program continued on next page 
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100 NEXT I 
110 END 

JRUN [Ret] 
1 1 
2 4 
3 9 


In the preceding example, line 10 jumps over the subroutine to 
the main program body. When the program reaches line 90, the 
GOSUB is executed. The program branches to line 20. When the 
RETURN in line 50 is reached, program execution jumps back to 
line 100. This process continues until the FOR counter reaches 3. 


# Applesoft 
GOTO w Integer 


The GOTO statement branches program control to another 
program line. 


Configuration 
GOTO line 
line is the line number of the statement to be branched to. 
Example 
10 PRINT “FIRST” 
20 GOTO 40 
30 PRINT “MIDDLE” 


40 PRINT “LAST” 
50 END 
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@ Applesoft 
GR m Integer 


The GR statement sets and clears the low resolution screen mode 
(40x40 with 4 lines of text at the bottom of the screen). 


Configuration 
GR 


This statement should be executed before the graphics state- 
ments PLOT, HLIN.. AT, and VLIN..AT are used. 


When the GR statement is executed, the color is automatically 
set to 0 (BLACK). 


Example 

10 GR 

20 COLOR = 15 
30 PLOT 19, 23 
40 END 


The preceding example should put a white square on the screen. 
If line 10 was omitted, a zero would be placed in the middle of 
the screen, because the low-resolution mode was not set. 


If you wish to return to the normal mode, you can do so by 
executing the TEXT statement. 


If full-screen graphics (40x48) is desired, this can be accomplished 
by executing POKE -16302,0 after GR has been executed. POKE 
-16301,0 can be used to restore the text window. 


# Applesoft 
HCOLOR O Integer 


The HCOLOR statement defines the next color to be displayed 
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by the graphics statements, HPLOT, DRAW, and XDRAW. 
HCOLOR is used in the high resolution graphics mode. 


Configuration 
HCOLOR = number 
number is a numeric expression or numeric constant that 
evaluates to a real number or integer between 0 and 7. Values 


outside this range will produce an error. The colors and their 
associated numbers are shown below. 


0 - Black 1 4 - Black 2 

1 - Green* 5 - Orange (Red)* 
2 - Violet* 6 - Blue* 

3 - White 1 7 - White 2 


*The actual color depends on the CRT. 


HPLOT, DRAW, and XDRAW will all output lines in the color 
indicated by HCOLOR until a subsequent HCOLOR statement is 
executed. 


= Applesoft 
HGR D Integer 


The HGR statement sets and clears the high-resolution graphics 
mode (280x160), with 4 lines of text at the bottom of the screen. 


Configuration 
HGR 


The HGR statement displays page one of the high-resolution 
screen, leaving 4 lines of text at the bottom. If fullscreen graphics 
(280x192) is preferred, the statement POKE -16302,0 will set the 
rest of the screen to graphics. A POKE -16301,0 restores the 4 
lines of text. 
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Example 
JHGR 


When the preceding example is executed, the high-resolution 
graphics mode will be set and the screen will be cleared to black. 
There will also be four lines of text at the bottom. If the cursor is 
not visible, press the return key until it appears. The cursor may 
not be visible if it is located in the graphics area of the screen 
rather than the text area. 


w Applesoft 
HGR2 O Integer 


HGR2 sets the screen to the high resolution graphics mode 
without the text lines at the bottom of the display (280x192). Page 
2 of high-resolution screen memory is displayed by HGR2. 


Configuration 


HGR2 


In the 80-column mode, HGR2 displays page 1 of screen memory 
rather then page 2. This can be illustrated by running the follow- 
ing example in both the 40 and 80 column modes. It appears that 
this is due to the fact that the softswitch that activates screen two 
does not work in the 80-column mode. 


Example 


10 HGR 

20 HCOLOR = 2 

30 HPLOT 100,100 TO 150,180 

35 FOR | =1 TO 1000: NEXT | 

40 TEXT 

50 INPUT “PRESS RETURN TO SEE PAGE 2”; A$ 
60 HGR2 

70 HPLOT 0,0 TO 100,0 
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w Applesoft 
HIMEM m Integer 


The HIMEM statement defines the address of the highest 
memory location available to a BASIC program. 


Configuration 


HIMEM: number 


number is anumeric constant or numeric expression. The value 
of number should indicate the highest available memory address. 
This value must lie between -65535 to 65535 (-32767 to 32767 in 
Integer BASIC). 


The current value of HIMEM can be displayed by entering: 


PRINT PEEK (116) *256 + PEEK (115) for Applesoft 
PRINT PEEK (77) *256 + PEEK (76) for Integer BASIC 


If the HIMEM: is set lower than LOMEM or Set so low that there is 
not enough room for the program to run, an out of memory 
error will occur. 


HIMEM can only be used in the immediate mode in Integer 
BASIC. 


The value of HIMEM is not changed by the commands NEW, 
CLEAR, RUN, and DEL. 


The HIMEM statement is generally used to reserve memory for a 
machine language subroutine called by the BASIC program. The 
HIMEM statement keeps BASIC variable and array storage 
separate from the machine language subroutine. 
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Example 


HIMEM: 33024 


The preceding example sets high memory to memory address 
33024. Variable and string storage will begin at this address and 
extend downward into memory. 


8 Applesoft 
HLIN m Integer 


HLIN is used in the low resolution graphics mode to draw a 
horizontal line on the screen. 


Configuration 


HLIN column 1, column 2 AT row 


column 1,column 2, and rowcan be either numeric constants or 
numeric expressions. column 1 and column 2 must lie in the 
range of 0 to 39. Also, the value of column 7 must be less than or 
equal to column 2. Row must lie in the range of 0 to 47. 


If an incorrect value is used for column 1, column 2, or row, the 
following error message will be displayed: 


ILLEGAL QUANTITY ERROR 


If HLIN is executed in the text mode, a line of characters rather 
than graphics points will be displayed. Also, if the low resolution 
graphics mode with the text mode is active, and HLIN plots to 
rows 42 to 47, a line of characters will be displayed. 


Example 


10 GR 

20 COLOR =3 

30 HLIN 0, 39 AT 20 
40 END 
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The preceding example will draw a purple line across the screen 
at row 20. 


m Appiesoft 
HOME O Integer 


The HOME statement clears the screen and places the cursor in 
the upper left hand corner of the screen. 


Configuration 
HOME 


The HOME command is not available in Integer BASIC. The 
cursor can be HOME’d in Integer BASIC by executing CALL-936. 


Example 


HOME 


mw Appiesoft 
HPLOT O Integer 


The HPLOT statement can be used to place a dot or draw a line 
on the high resolution graphics screen. The color of the dot must 
have been previously defined by the HCOLOR statement. 


Configuration 


HPLOT column 7, row 1 [TO column 2, row 2...] 
HPLOT TO column, row 


column, row, column 1, column 2, row1, and row 2 arenumeric 
constants or numeric expressions. column, column 1, and 
column 2 must lie between 0 and 279. The row, row 7, and row 2 
must lie between 0 and 191. 
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If the HPLOT is used as shown in the first configuration without 
the optional (TO column 2, row 2), a dot will be plotted. The 
optional TO will connect the two dots. If the column 71 androw1 
preceding the TO are omitted, the line will be drawn from the 
previous point plotted to the point indicated by column 2, row 2. 


Example 


10 HGR 

20 HCOLOR =3 

30 HPLOT 0,0 

40 HPLOT TO 0,50 TO 50,50 
50 HPLOT TO 50,0 TO 0,0 


The preceding example will draw a square in the upper left hand 
corner of the screen. 


= Applesoft 
HTAB O Integer 





The HTAB statement positions the cursor at the location specified 
by its argument. 


Configuration 
HTAB argument 


argument is a numeric constant or numeric expression. The 
argument must be between 1 and 80. 


The cursor will be moved to the position specified by the 
argument. HTAB moves the cursor without erasing any displayed 
characters. 
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Example 


10 PRINT “1234567890” 
20 HTAB 3: PRINT 3; 
30 HTAB 9: PRINT 9; 
40 HTAB 5: PRINT 5 
JRUN [Ret] 
1234567890 

35 9 


In the preceding example, line 20 places the cursor at position 3 
and displays a 3. In line 30, the cursor is moved to position 9. The 
PRINT statement displays a9. In line 40, HTAB moves the cursor 
back to position 5, and the PRINT statement displays a 5. 


m Applesoft 
IF.. THEN = Integer 





The IF.. THEN statement sets up a condition which will influence 
the program flow. 


Configuration 
IF expression THEN statement [:statement...] 


expression is a conditional expression. statement can be any 
BASIC statement. 


If the expression is evaluated as true, the THEN portion of the 
statement will be executed. 


In Applesoft BASIC, if the expression evaluates as true, the 
statement following THEN will be executed. If the expression 
evaluates as false, the statement in the next program line will be 
executed. 


In Integer BASIC, if the expression evaluates as true, the 
statement(s) following THEN will be executed. If the expression 
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evaluates as false, the statement immediately following THEN 
will not be executed. Program control will branch to the next 
statement even if that statement is on the same program line as 
the IF, THEN statement. 


For example, if the following statement evaluated as true, 
IF X=15 THEN PRINT “TRUE”:PRINT X 
the following would be displayed: 


TRUE 
15 


If this statement evaluated as false, TRUE would not be displayed. 
However, the value for X would be displayed. 


Example 


Applesoft 100 IF X >8 THEN X =0 
110 Y = Y+1 


Integer 100 IF X >8 THEN X =0: Y =Y+1 


@ Applesoft 
IN# w Integer 


IN# specifies the peripheral slot which will be providing sub- 
sequent input for the Ile. 


Configuration 

IN# argument 
argument is a numeric constant or numeric expression which 
specifies the peripheral slot. The numeric constant must be an 


integer for Integer BASIC. The value of the argument must be 
between 1 and 7. 
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lf there is no peripheral in the specified slot, the system will 
hang. Press the Reset key to exit this situation. 

Example 


IN#2 


@ Applesoft 
INT O Integer 





The INT function returns the integer value of the specified 
argument. 


Configuration 
INT (argument) 
argument is a numeric constant or numeric expression. 


The value returned will always be less than or equal to the 
original value. 


Example 


PRINT INT (1.7), INT (-1.7) 
1 —2 


Inthe above example, 1.7 is returned as a1 and -1.7 is returned as 
—2. 


# Applesoft 
INVERSE 0 Integer 


The INVERSE statement turns on the INVERSE (reverse) video. 
Following the execution of the INVERSE statement, any charac- 
ters displayed by the computer will be in inverse (i.e. characters 
will be displayed as black characters on a white background.) 
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Configuration 
INVERSE 


The INVERSE mode works by altering the standard ASCII code. 
Therefore, any characters sent to the disk or printer while the 
INVERSE mode is on, may be sent with the incorrect codes. 

63 
The INVERSE statement is equivalent to POKE 50, 127% The 
INVERSE statement can be turned off by the NORMAL statement. 


Example 
] INVERSE 
] PRINT “++” 
+ 
® Applesoft 
INPUT m Integer 


The INPUT statement accepts data entry from the keyboard or 
another input device while the program is being executed. 


Configuration 


Applesoft INPUT ["message”;] variable [,variable] 
Integer INPUT [“message”,] variable [,variable] 


message is a string used as a prompt. variable can be any valid 
BASIC variable. 


When an INPUT statement is executed, program execution will 
stop temporarily. If a prompt was included, the prompt will be 
displayed. In Applesoft, a question mark will be displayed if 
there is no prompt. in Integer BASIC, a question mark will follow 
the prompt if the variable is an integer variable. 


118 Apple !le Users Handbook 


After the INPUT statement has been executed, the user may 
enter the desired data at the keyboard. That data is assigned to 
the variable(s) listed in the INPUT statement. The number of data 
items entered must equal the number of variables listed. Also, 
the type of data entered must agree with the type specified in 
variable. The data items must be delimited by commas when 
input. 


Example 


Applesoft 10 INPUT “ENTER A NUMBER”: A 
20 PRINT “THE NUMBER IS”; A 
30 END 
JRUN [Ret] 
ENTER A NUMBER 4.5_ 
THE NUMBER is 4.5 


Integer 10 INPUT “ENTER A NUMBER”, A 
20 PRINT “THE NUMBER IS”; A 
30 END 
> RUN [Ret] 
ENTER A NUMBER? 4 
THE NUMBER IS 4 


# Applesoft 
LEFT$ O Integer 





The LEFT$ function returns the number of characters specified in 
the second expression of the argument to the leftmost of the 
string specified in the first part of the argument. 

Configuration 


LEFT$ (a$,x) 


a$ is a string constant searched by the function. x is the number 
of characters to be returned. 
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Integer BASIC can duplicate this function by using string arrays. 
Example 


10 A$ =”ABCDEFG” 
20 PRINT LEFT$ (A$, 3) 
30 END 

JRUN [Ret] 

ABC 


The preceding LEFT$ function returned the 3 leftmost characters 
in A$. 


In Integer BASIC, the statement PRINT A$ (1,3) would return the 
same characters. (Be sure that the variable A$ has previously 
been dimensioned to 7 in Integer BASIC.) 


= Applesoft 
LEN w Integer 





The LEN function returns the number of characters in a string. 
Configuration 
LEN (a$) 
a$ is a string constant. 
Example 


PRINT LEN (“APPLE”) 
5 
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# Applesoft 
LET @ Integer 





The LET statement is an optional assignment statement. An 
assignment statement determines the value of an expression and 
then assigns that result to the variable named in the assignment 


statement. 


Configuration 
LET variable = expression 


variable must be of the same data type as the expression. For 
example, if variable is a string, expression must also be astring. If 
variable is an integer or real number, then expression must also 


be numeric. 


Example 
10 LET C=1+A 
20 L=C*2 
@ Applesoft 
LIST w Integer 


The LIST command is used to list the program stored in memory 
on the video display or other device. 


Configuration 


Applesoft LIST a [{-\[b]] 
or 


LIST [[a]{-]6 
Integer LIST a [,b] 
a and b are integers greater than or equal to 0. In Applesoft 


BASIC, if a is greater than b, no lines will be listed. In Integer 
BASIC, if b is less than a only line a will be listed. 
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If a is not a line number in the program, the next highest line 
number will be used. If bis not a line number in the program, the 
next lowest line number will be used. 


In Applesoft, a LIST 0 statement will list all the lines in a program. 
For example, LIST 100,0 would list all the lines from line 100 to the 
end of the program. 


In Applesoft, LIST can be frozen by Ctrl-S. Pressing any other key 
will resume LIST. The listing may be stopped by pressing Ctrl-C. 


Example 


LIST 10 [Ret] 

10 GR 

LIST 10,50 [Ret] 

10 GR 

20 POKE -16302,0 
30 COLOR =3 

40 GOSUB 5000 
50 COLOR =7 


# Applesoft 
LOAD w Integer 


The LOAD command is used to load a program from a storage 
device to the computer. 


Configuration 


Cassette LOAD 
*Disk LOAD filename [,D drive][,V volume][,S slot] 


filename is the name of the program. drive is the drive that the 
file isin and volume is the volume number of the diskette. slot is 
the slot the disk interface card is in. 


* LOAD is only interpreted as a BASIC reserved word when used 
with the cassette unit. 
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When using the cassette LOAD, first make sure that the current 
language is active (Applesoft or Integer BASIC). Position the tape 
to the beginning of the program, type LOAD, and press return. 
The cursor will disappear and after a few seconds the Apple will 
beep. The beep indicates that LOAD has started. When the 
second beep sounds, the LOAD will be finished. If an error 
occurred, turn off the computer, turn it on, and try again. 


In the DOS LOAD, LOAD need only be entered with the 
program name, and the return key pressed. If the indicated file 
name is not present on the specified diskette, the FILE NOT 
FOUND error will occur. 


Example 


LOAD 


= Applesoft 
LOG O Integer 





The LOG function returns the natural log of the argument. 
Configuration 
LOG (argument) 


argument is a numeric constant or numeric expression greater 
than 0. 


The natural log is undefined for negative numbers. 


Example 


PRINT LOG (25) 
3.21887583 
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@ Applesoft 
LOMEM: @ Integer 





The LOMEM statement defines the address of the lowest 
memory location available for BASIC. 


Configuration 
LOMEM: number 


number is a numeric constant or numeric expression. The value 
of number should be the lowest available memory address. This 
value must lie between -65535 to 65535 (-32767 to 32767 in 
Integer BASIC). 


The current value of LOMEM can be displayed by entering 
PRINT PEEK (106) *256 + PEEK (105). 


If LOMEM is set higher than the HIMEM an error will occur. 
LOMEM cannot be set lower than 2048. 


LOMEM can only be used in the immediate mode in Integer 
BASIC. It cannot be used within a program. 


LOMEM cannot beset lower than its current value. LOMEM can 
only be increased. 


LOMEM will be reset by the NEW or DEL commands or by adding 
or changing a line. 


Example 


10 F = PEEK(106) * 256 + PEEK(105) 
20 PRINT “LOMEM IS”:F 

30 LOMEM: 3000 

40 F = PEEK(106) * 256 + PEEK(105) 
50 PRINT “LOMEM IS NOW”: F 
60 END 
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In the preceding example, LOMEM is calculated on line 10 and 
then displayed on line 20. LOMEM is then set to 3000 in line 30. 
Line 0 then recalculates the LOMEM value. The LOMEM setting 
is finally displayed by the PRINT statement in line 50. 


O Applesoft 
MAN w Integer 


The MAN command is used to turn off the automatic generation 
of program lines. 


Configuration 
MAN 


When the computer is automatically generating program lines, 
Ctrl-X must be pressed before entering the MAN command. 


Example 


> AUTO 10 [Ret] 

>10 REMTEST. [Ret] 

>20\ Ctrl-X entered by user 
> MAN [Ret] 


In the preceding example, the AUTO was turned off by the 
combination of Ctrl-X and MAN. 


# Applesoft 
MID$ | O Integer 


The MID$ function returns the portion of a string specified by its 
argument. 
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Configuration 
MID$ (a$, b[,c]) 


a§$ is a string constant. b and c are numeric constants or numeric 
expressions with a value between 0 and 255. b is the first 
character in a$ being returned. c is the number of characters in 
a$ being returned. If c is not included, all characters to the right 
of the position given in b will be returned. 


The MID$ function can be duplicated in Integer BASIC using 
string arrays. 


Example 


10 N$ = “COMPUTER” 
20 PRINT MID$ (N$, 4, 3) 
30 END 

JRUN [Ret] 

PUT 


In the preceding example, the fourth position in the string N$ is 
the starting position. The 3 indicates 3 characters. This could be 
duplicated in Integer BASIC by using N$(4,6) in place of MID$ 
(N$,1,3). Integer BASIC also requires that the string variable had 
been dimensioned as DIM N§(8). 


@ Applesoft 
NEW m Integer 


The NEW command deletes the program in memory and clears 
all variables. 


Configuration 


NEW 
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The NEW command is generally used to free memory space 
before a new program is entered. 


Example 


> LIST [Ret] 
10 TEXT 
20 END 

> NEW [Ret] 

> LIST [Ret] 


= Applesoft 
NORMAL D Integer 


The NORMAL statement turns off the FLASH or INVERSE 
statements. 


Configuration 
NORMAL 
The NORMAL statement sets the video output mode to white 
characters on a black background. The NORMAL statement is 
equivalent to the POKE 50,255 statement. Since NORMAL is not 
available in Integer BASIC, the POKE 50,255 can be used in its 
place. 


Example 


NORMAL 


8 Applesoft 
NOT w Integer 





The NOT function logically compliments the value given in the 
argument. 
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Configuration 
NOT argument 


argument is a numeric constant or numeric expression. In 
Integer BASIC the numeric constant must be an integer. If the 
argument evaluates to true (non-zero), false (zero) will be 
returned. If the argument evaluates to false (zero), true (one) will 
be returned. 


NOT 1=0 
NOT 0=1 
Example 


10 A=2 
20 IF NOT (A =1) 
THEN PRINT “A DOES NOT EQUAL ONE” 
30 END 
JRUN [Ret] 
A DOES NOT EQUAL ONE 


® Applesoft 
NO TRACE m Integer 


The NO TRACE command turns off the TRACE command. 
Configuration 
NO TRACE 
The NO TRACE command may be used as a program statement. 
Example 


NO TRACE 
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= Applesoft 
ON O Integer 


The ON statement is used in conjunction with GOTO and 
GOSUB. The statements are used to branch program control to 
one of several program lines depending on the value appearing 
after ON. 


Configuration 


ON exp GOTO line [,line ...] 
ON exp GOSUB line [,line ...] 


exp can be any numeric constant or numeric expression. line is 
the line number the program is to branch to. 


The value of exp controls which line is to be branched to. For 
instance, if exp evaluates to 1, program control will branch to the 
line number given in the first line. If exp evaluates to 2, program 
control will branch to the second line, etc... 


If the ON...GOSUB statement is being used, the line number 
specified in fine must be that of a subroutine. In other words, a 
RETURN statement eventually will have to be executed to return 
program control. 


If exp evaluates to zero or to a number greater than the number 
of lines specified after GOTO or GOSUB, the program will 
continue with the next executable statement. 


Example 


10 INPUT “ENTER A NUMBER BETWEEN 1 AND 4 ”;1 

20 ON | GOTO 60,80,100,120 

30 PRINT 

40 INPUT “PLEASE ENTER A NUMBER BETWEEN 1 AND 4 “;1 
50 GOTO 20 

60 PRINT “YOU ENTERED A ONE” 

70 GOTO 130 


program continued on the next page 
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80 PRINT “YOU ENTERED A TWO” 
90 GOTO 130 

100 PRINT "YOU ENTERED A THREE” 
110 GOTO 130 

120 PRINT “YOU ENTERED A FOUR” 
130 END 


In the preceding example, line 10 prompts the user to enter a 
number between one and four. In line 20, an ON...GOTO will 
branch control to a different line depending on the value of I. If] 
is one, program execution will branch to 60. If lis two, program 
execution will branch to 80, etc. If zero or anumber greater than 
four was entered, program execution will continue to line 30. 


m Applesoft 
ONERR GOTO O Integer 


The ONERR statement allows errors to be trapped. The statement 
then transfers program control to an error handling routine at 
the indicated line number. 


Configuration 
ONERR GOTO line 


line is the first line of the error handling routine. ONERR GOTO 
should be executed before the error has occurred. 


When Applesoft executes a program, it executes the program 
line by line. If an error occurs during program execution, 
Applesoft will check to see if an ONERR GOTO statement has 
been executed. If no ONERR GOTO statement had been 
executed, Applesoft will halt program execution and display the 
error. Otherwise the program will branch to the line indicated in 
the ONERR GOTO statement. 


POKE 216,0 turns off any previously executed ONERR GOTO 
statement. 
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To find out what error has occurred, execute PEEK (222). The 
value returned will be the error code. The following list indicates 
the various Applesoft error codes and their respective error 
messages. 


NEXT without FOR 
Syntax 
RETURN without GOSUB 
Out of DATA 
Illegal Quantity 
Overflow 
Out of Memory 
Undefined Statement 
Bad Subscript 
Redimensioned Array 
Division by Zero 
Type Mismatch 
String Too Long 
Formula Too Complex 
Undefined Function 
Bad Response to INPUT Statement 
Ctrl C Interrupt Attempted 





For a list of DOS errors and error codes, see Appendix F. 


The RESUME command can be used to return the program to the 
beginning of the statement where the error occurred. 
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Example 


10 ONERR GOTO 1000 

20 INPUT “ENTER A NUMBER”; A 

30 PRINT “A ="; A 

40 END 

1000 E = PEEK (222): REM ERROR CODE 

1010 IF E = 255 THEN END: REM Ctrl-C ENTERED 

1020 IF E = 254 THE PRINT “INVALID ENTRY”: RESUME 

1030 IF E=69 THEN PRINT “NUMBER TOO LARGE/ 
TOO MANY DIGITS”: RESUME 

1040 PRINT “ERROR CODE”; E 

1050 END 


JRUN [Ret] 

ENTER A NUMBER ONE_ [Ret] 

INVALID ENTRY 

ENTER A NUMBER 7E50_ [Ret] 

NUMBER TOO LARGE/TOO MANY DIGITS 
ENTER A NUMBER 5. [Ret] 

A=5 


In line 10, the ONERR routine is set. When an invalid number was 
entered in response to the INPUT statement in line 20, the 
program branched to line 1000 where E was assigned the proper 
error code. Lines 1010-1030 check the variable E for its value. If E = 
255, then a Ctrl-C was entered. If E = 254, an invalid number was 
entered. If E=69, the number entered was too large or had too 
many digits. Lines 1020 and 1030 incorporate the RESUME 
statement to branch back to line 20. 


@ Applesoft 
OR m Integer 


OR is a logical math operator. This reserved word is generally 
used in conjunction with the IF... THEN statement. 
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Configuration 
expression 1 OR expression 2 
expression 1 and expression 2 are Boolean expressions. If the 


expression is numeric (non-zero), it will be evaluated to true. A 
zero is treated as false. A truth table for OR is illustrated below. 





In both Applesoft and Integer BASIC, a true is represented by a1 
and false by a 0. 


Example 
10 A=3 
20 B=5 
30 IF (B <A) OR (B =5) THEN 50 
40 END 


50 PRINT “EITHER B IS LESS THAN A” 
60 PRINT “OR BIS EQUAL TO 5” 
70 END 


JRUN [Ret] 
EITHER B IS LESS THAN A 
OR BIS EQUALTO 5 


In the preceding example, B is not less than A, but B is equal to 5. 
Therefore, the whole OR expression is true, and the program 
branches to line 50. 
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= Applesoft 
PDL w Integer 





The PDL function returns the value of one of the four different 
game controllers (paddles). 


Configuration 
PDL (argument) 


argument is a numeric constant or numeric expression. The 
numeric constant must be an integer in Integer BASIC. The value 
of the argument must lie between 0 and 255. The value of the 
argument corresponds to the game controller. For example, X = 
PDL(0) returns the position of game controller number zero. The 
number returned will be beteen 0 and 255. 


If the value of the argument is between 4 and 255, the PDL 
function will return an unpredictable number. Using an 
argument between 4 and 255 can also produce unwanted side 
effects which affect program execution. 


Example 


PRINT PDL(0) 
120 


@ Applesoft 
PEEK @ Integer 


The PEEK function returns the contents of the memory address 
given in the argument. 


Configuration 


PEEK (argument) 
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argument is anumeric constant or numeric expression between 
-65535 and 65535 (-32767 to 32767 in Integer BASIC). The 
numeric constant must be an integer in Integer BASIC. 


The decimal integer returned by the function will lie between 0 
and 255. 


Example 


PRINT PEEK (-857) 
202 


The preceding example returns the contents of location -857. 


8 Applesoft 
PLOT m Integer 





The PLOT statement plots a dot on the low resolution graphics 
screen. The color of the dot must have been previously defined 
by the COLOR statement. 


Configuration 
PLOT column, row 
column and row must be a numeric constant or a numeric 
expression. The numeric constant must be an integer for Integer 
BASIC. column must lie between 0 and 39 and row must lie 


between 0 and 47. 


The PLOT occurs at the position specified. For example PLOT 3,5 
would place a dot at row five and column three. 


The origin (0,0) is located in the upper left hand corner of the 
screen. 
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If a PLOT statement is executed when the text mode is active a 
character will be placed where the dot should have appeared. 
The same will happen if a PLOT is made in the row range of 40 
and 47 in the mixed graphics-text mode. 


Example 


10 GR 

20 COLOR =3 

30 FOR | =0 TO 39 
40 PLOT I, 

50 NEXT | 

60 END 


The preceding example will draw a diagonal line across the 
screen. 


= Applesoft 
POKE m Integer 


The POKE statement stores one byte of information in the 
memory location specified. 
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Configuration 
POKE address, value 


address and value are numeric constants or numeric expressions. 
address or value must evaluate to an integer in Integer BASIC. 
address lies between -65535 and 65535 (-32767 and 32767 in 
Integer BASIC.) value must lie between 0 and 255. 


The POKE statement places the indicated value at the specified 
memory address. A POKE has no effect if the address is in ROM 
memory. If a POKE is not used carefully, it can disrupt the Ile’s 
execution. 


Example 


10 PRINT PEEK(7900) 
20 POKE 7900,37 

30 PRINT PEEK(7900) 
40 POKE 7900,158 
50 PRINT PEEK(7900) 
60 END 


In the preceding example, line 10 first displays what is currently 
in memory location 7900. The value 37 is then poked into 
memory on line 20. Line 30 displays the value at memory location 
7900. The value 158 is then poked into memory and displayed in 
lines 40 and 50. 


@ Applesoft 
POP m integer 


The POP statement causes a program to ignore the GOSUB or 
ON/GOSUB statement that was executed last. 


Configuration 


POP 
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In effect, aGOSUB or ON/GOSUB statement is converted to a 
GOTO or ON/GOTO statement when POP is executed. The 
program “forgets” that it is in a subroutine. As a result, when a 
POP statement is executed, the next RETURN statement branches 
the program control to the line after the GOSUB statement 
before the previous GOSUB statement. In other words, the 
program “forgets” where the subroutine was called from, so it 
returns to a previous GOSUB statement. 


A POP statement is used, in general, to exit a subroutine. 
Example 


10 X=5 

20 Y=10 

30 GOSUB 100 
40 END 

100 PRINT X 
110 IF X >0 THEN POP:GOTO 130 
120 RETURN 
130 PRINT Y 
140 END 

JRUN [Ret] 

5 


10 


The previous example contains a program that uses a POP 
statement to exit a subroutine. At line 10, X is assigned the value 
5. At line 20, Y is assigned the value 10. At line 30, the subroutine 
at line 100 is called. 


At line 100, the value of X is displayed. Line 110 is an IF/THEN 
statement that tests the condition X > 0. Since the value of X is 
greater than zero, the condition is true. As a result, the POP 
statement is executed, and the program control branches to line 
130. At line 130, the value of Y is displayed. 
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Since the POP statement was executed, the program is no longer 
in the subroutine. If another RETURN statement is executed, the 
program will not return to line 30, where the subroutine was 
called. The program will return to the line of the previous 
GOSUB statement. Since there is no other GOSUB statement in 
this program, a RETURN statement would cause an error. 


A POP statement can also be used to make the program ignore 
the previous FOR statement. When a POP statement is executed 
within a FOR/NEXT loop, the loop will not be repeated. 
However, an error occurs if a NEXT statement is executed for that 
loop. 


# Applesoft 
POS O Integer 


The POS function returns the current horizontal position of the 
cursor. 


Configuration 
POS (argument) 
argument can be any legal Applesoft constant or expression. 


The number returned will be an integer from 0 to 39. The 
leftmost position is 0. 


Example 


JHTAB 7 : PRINT POS(0) 
6 

]PRINT TAB(7); POS(0) 
6 

JPRINT SPC(7); POS(0) 
7 
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Inthe previous example, the HTAB and TAB functions count the 
leftmost position as 1. The SPC and POS functions treat the 
leftmost position as 0. 


# Applesoft 
PRINT m Integer 





PRINT is used to display information to the screen or to another 
output device. 


Configuration 
PRINT [expression] [3...[expression]...] 


expression can be any valid numeric or string constant or 
expression. 


expression can include string and numeric variables, as well as 
string and numeric constants. Each variable name or constant 
must be separated by either a comma or a semicolon. When a 
comma separates the items in a PRINT statement, the display is 
divided into three display positions in Applesoft BASIC. These 
begin in columns 1, 17, and 33. In Integer BASIC, the display is 
divided into five fields whose display positions begin at columns 
1,9, 17, 25, and 33. 


A PRINT statement can end with acomma, semicolon, or with no 
punctuation at all. A PRINT statement that ends with asemicolon 
causes any subsequent PRINT statement output to appear at the 
next position on the same row of output. 


When a PRINT statement ends with a comma, the next PRINT 
statement output occurs at the next PRINT display position on 
the same row of output. 


When a PRINT statement has no punctuation at the end, the next 
line of output automatically occurs on the next display line. 





* When the 80-column card is active the only two tab positions 
are set (columns 1,9 in Integer; 1,17 in Applesoft). 
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® Applesoft 
PR# B Integer 


(pe a i a ee I I ELE ED, 


PR# specifies the peripheral slot which will be providing subse- 
quent output for the Ile. 


Configuration 
PR# argument 


argument is a numeric constant or numeric expression which 
specifies the peripheral slot. The numeric constant must be an 
integer for Integer BASIC. The value of the argument must be 
between 1 and 7. 


If there is not peripheral in the specified slot the system will 
hang. Press the reset key to exit this situation. 


# Applesoft 
READ O Integer 





A READ statement is used to assign values to variables. The values 
are taken individually from DATA statements in the order they 
appear in the program. 


Configuration 


READ a ,D 
a$ bs | 


Data items are assigned to variables in the order in which they 
appear in the program unless a RESTORE statement has been 
executed. 


The type of variable in the READ statement must correspond to 
the type of data in the corresponding DATA statement. A 
numeric variable can only be assigned a numeric value. However, 
a string variable can accept any type of character or none at all. 


A program must include at least as many data items as the 
number of variables in its READ statements unless a RESTORE 
statement is executed. 
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Example 


20 READ X,x$ 

30 PRINT X$,X 

40 END 

50 DATA 12, JONES 
IRUN [Ret] 

JONES 12 


The preceding example contains a program that has a READ 
statement. At line 20, the variables X and X$ are assigned the 
values from the DATA statement at line 50. At line 30, the values 
of the two variables are displayed. 


A READ statement can accept data from a DATA statement that 
appears anywhere in a program. A DATA statement does not 
have to precede the READ statement in order to be effective. 


@ Applesoft 
RECALL O Integer 





RECALL is used to recover a numeric array from cassette tape 
which previously was saved on tape with the STORE statement. 


Configuration 
RECALL array 


It is not necessary to use the same array variable name in the 
RECALL statement that was used in the STORE statement. 
However, that array should be dimensioned with the same 
number of elements in the same dimensions as the array that was 
stored. If the array being recalled was dimensioned with fewer 
elements than the stored array, the following error messge will 
be displayed: 


OUT OF MEMORY ERROR 
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If the array being recalled was dimensioned with more elements 
than the stored array, the values in the recalled array may be in 
the wrong order. 


However, the recalled array may be dimensioned with more 
elements than the stored array if only one final dimension is 
larger. For example, if the stored array was dimensioned as 
follows, 

DIM A(10,10) 
and the recalled array was dimensioned as: 

DIM A(12,10) 
the values recalled would be out of order. 
However, if the recalled array was dimensioned as, 


DIM A(10,12) 


the recalled values would be in the correct order with zeros 
stored in the extra array elements. 


lf the recalled array is dimensioned with the same number of 
elements as the stored array but with different dimensions, any 
of the following error messages or error conditions could result: 


ERR OUT OF MEMORY ERROR 
Extra zero values Data out of order 
in the recalled array in the array 


The user is not prompted with cassette operating instructions 
during the execution of either STORE or RECALL. It is a good 
programming practice to precede STORE and RECALL state- 
ments with PRINT statement prompts instructing the operator to 
press the proper cassette recorder keys. 
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The cassette recorder must be in the record mode when STORE 
is executed. The recorder will beep once when recording 
begins, and will beep a second time when it ends. 


The cassette recorder must be in the play mode when RECALL is 
executed. The recorder will beep once when the reading begins 
and a second time when it ends. 


Example* 
JLOAD STOR1 [Ret] 
JLIST [Ret] 
5 REM STOR1-- STORE EXAMPLE 
10 DIM A(9) 


15 DATA 1,2,3,4,5,6,7,8,9,10 

20 FOR X =0TO9 

30 READ A(X) 

40 NEXT X 

50 INPUT “SET THE RECORDER ON RECORD 
AND PRESS RETURN"; A$ 

60 STOREA 

JRUN [Ret] 

SET THE RECORDER ON RECORD AND PRESS RETURN 

JNEW [Ret] | Press Play & Record on Cassette 

JLQAD RECAL1 [Ret] 

JLIST [Ret] 

5 REM RECAL1-- RECALL EXAMPLE 

10 DIM A(9) 

20 INPUT “PRESS PLAY ON THE RECORDER 
AND PRESS RETURN”; A$ 

30 RECALL A 

40 FOR X=0TO9 

50 PRINT A(X) 

60 NEXT 

JRUN [Ret] 


program continued on the next page 





* This example assumes STOR1 and RECAL1 had previously 
been saved on diskette. 
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PRESS PLAY ON THE RECORDER AND PRESS RETURN 


1 | Rewind Recorder 
2 Press Play 
3 
4 
5 
6 
7 
8 
9 
10 
@ Applesoft 


REM m Integer 


A REM statement is used to insert comments in a program. The 
REM statement is ignored by the BASIC interpreter. 


Configuration 
REM remarks 
Example 
REM INPUT ROUTINE 
Any statements that follow a REM statement, on the same line, 
are also ignored by the computer. As a result, a REM statement is 


generally used on its own line or at the end of a multiple 
statement line. 


@ Applesoft 
RESTORE O Integer 


A RESTORE statement is used to move the DATA statement 
pointer to the beginning of the DATA item list. 
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Configuration 
RESTORE 


The data in a program is read in order, starting with the first 
DATA statement item. In order to reread the data, a RESTORE 
statement is necessary. 


When a RESTORE statement is executed, the next READ state- 
ment will assign to its first variable the first data value that 
appears in the program. 


Example 


10 READ A1,B1,C1,X1$ 
20 PRINT A1,B1,C1 

30 PRINT X1$ 

40 RESTORE 

50 PRINT 

60 READ A2,B2,C2,X2$ 
70 PRINT A2,B2,C2 

80 PRINT X2$ 

90 READ X3$ 
100 PRINT X3$ 
110 DATA 32,-102,2.12,RECTOR,SPALL 


In the preceding example, data is read into the variables 
indicated in line 10. The data is then displayed in lines 20 and 30. 
The RESTORE statement in line 40 allows the data items read in 
line 10 to be read again. 


m Applesoft 
RESUME O Integer 


RESUME is used in Applesoft BASIC to resume program exe- 
cution after an ONERR GOTO statement has branched program 
control to an error routine. 
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Configuration 
RESUME 
If RESUME is executed without an error having previously 


occurred, the program willstop, the system will hang, or an error 
message may result. 


= Applesoft 
RETURN O Integer 





A RETURN statement is used to branch a program back to the 
line where the last subroutine was called. 


Configuration 
RETURN 
A subroutine is called with aGOSUB or ON/GOSUB statement. 
When the subroutine has been completed, a RETURN statement 
causes program control to return to the statement following the 
most recently executed GOSUB or ON/GOSUB statement. 


Example 


RETURN 


@ Applesoft 
RIGHT$ D Integer 


The RIGHT$ statement is used to return the rightmost characters 
of a String. 


Configuration 


b$ = RIGHT$ (a$,c) 
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The RIGHT$ function returns a string value. The first argument is 
a string constant or a string variable. The second argument is a 
numeric value. The string returned consists of the number of 
characters specified by the numeric argument. These characters 
are the rightmost characters in the string argument. 


Example 


10 A$ = "WILLIAM JONES” 
20 PRINT A$ 

30 PRINT RIGHT$(A$,5) 
JRUN [Ret] 

WILLIAM JONES 

JONES 


The preceding example contains a program that uses a RIGHT$ 
statement. At line 10, the string variable A$ is assigned the value 
"WILLIAM JONES”. At line 20, the value of A$ is printed. At line 
30, the rightmost 5 characters of the value of A$ are displayed. 


If the value of the numeric argument exceeds the length of the 
string argument, the entire string value is returned. If the value 
of the numeric argument is less than one or greater than 255, the 
following error message will be displayed: 


ILLEGAL QUANTITY ERROR 


m Applesoft 
RND m Integer 





The RND function is used to generate “random” numbers. 
Configuration 
X = RND (a) 


In Applesoft BASIC, RND will return a random number greater 
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than or equal to zero and less than one. If RND’s argument (a) is 
positive, a new random number will be generated each time 
RND is executed. 


RND can also be used with a negative argument. The same 
random number will be returned when RND is executed with 
the same negative value for a. 


If the same negative argument is repeated followed by RND 
statements with positive arguments, the same series of random 
numbers will be generated. This is illustrated in the following 
example. 


Example 


100 PRINT RND (-1) 
200 PRINT RND (3) 
300 PRINT RND (.22} 
400 PRINT RND (.33) 
500 PRINT RND (-1) 
600 PRINT RND (.99} 
700 PRINT RND (2.7) 
800 PRINT RND (.77) 
JRUN [Ret] 
2.99196472E-08 
738207502 
.272707136 
299733446 
2.99196472E-08 
738207502 
.272707136 
299733446 


In Applesoft BASIC, if a =0, RND will return the most recently 
generated random number. 


In Integer BASIC, RND returns a random integer with a value 
greater than or equal to zero but less than a. 


Apple BASIC Reference Guide 149 


mw Applesoft 
ROT= O Integer 


ROT= sets the amount of rotation for a shape which is to be 
drawn with either DRAW or XDRAW. 


Configuration 
ROT=x 


x can range from 0 through 255. The shape will be rotated 90 
degrees clockwise for every increment of 16 in the value of x. For 
example, ROT=0 causes the shape to be drawn in the same 
position in which it was originally defined. ROT=16 causes the 
shape to be rotated 90° clockwise. ROT=32 causes the shape to 
be drawn upside down. ROT=64 causes the shape to be drawn in 
its original position. 


The number of actual different rotations is limited by the SCALE= 
setting. Lower SCALE= settings will have fewer noticeable 
rotations. When SCALE= is set to one, there are only eight 
noticeable ROT= values. They are 0,8,16,24,32,40,48,56 and 
numbers greater than 63 which would use the MOD64 equi- 
valent. Ifa number other than 0,8,16,24,32,40,48, or 56 is used, the 
shape will generally be drawn with the lower corresponding 
ROT= value. 


ROT= is only regarded as a reserved word if the equal sign (=) is 
placed immediately following ROT without any intervening 
blanks, spaces or characters. 

Example 

ROT=32 
The ROT=statement given in our example would cause a shape 


previously defined by DRAW or XDRAW to be rotated 180 
degrees. 
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w Applesoft 
RUN @ Integer 





RUN is used to execute the BASIC program currently stored in 
memory. Prior to program execution, all variables, pointers, and 
stacks will be cleared. 


Configuration 
RUN [linenumber] 
If linenumber is specified, execution will begin at the specified 
line. If no linenumber is specified, execution will begin with the 
lowest line number. If a non-existent [inenumber is specified, 


one of the following error messages will result: 


***BAD BRANCH ERR _ Integer 
?UNDEF’D STATEMENT ERROR _  Applesoft 


In Integer BASIC, RUN can only be executed in the immediate 
mode. 


@ Applesoft 
SAVE w Integer 


The SAVE command is used to store a program on diskette or 
cassette. 


Configuration 


Cassette SAVE 
Diskette SAVE filename [Dx] [,Vx] [,5x] 


When using the cassette SAVE, the cassette recorder’s Play and 
Record keys must be depressed when SAVE is executed. 


The Ile will beep when it begins to save the program and will 
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beep a second time when the recording has been completed. At 
this time, the operator should stop the cassette recorder. 


SAVE is only interpreted as a BASIC reserved word when used 
with the cassette unit. 


In the DOS SAVE, SAVE need only be entered with the program's 
filename and the return key pressed. If the indicated filename 
duplicates that of a file in the same language already on the 
diskette, the contents of the original program will be erased and 
replaced with the new program. If the indicated filename 
duplicates that of a file in a different language or with a different 
file type, the following message will be displayed: 


FILE TYPE MISMATCH 
Example 


SAVE 


@ Applesoft 
SCALE= O Integer 


SCALE= is used to set the size of shapes drawn by DRAW or 
XDRAW in high resolution graphics. 


Configuration 
SCALE=x 


The integer value of x is multiplied by the size of the shape table. 
Therefore, when SCALE=1, a shape is drawn with the same scale 
as that with which it was defined. SCALE=2 causes the shape to be 
drawn at twice its defined size, etc. SCALE=0 causes the shape to 
be drawn at 256 times its defined size. 
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Example 


10 REM SET UP SCREEN 
20 TEXT:HGR 
30 FOR X = 7936 TO 7946 
40 READ V:REM READ IN SHAPE 
50 POKE X,V:REM POKE SHAPE INTO MEMORY 
60 NEXT X 
70 REM TELL WHERE SHAPE IS AT 
80 POKE 232,0: POKE 233,31 
90 HCOLOR = 3 
100 ROT =0 
110 FOR X =10 TO 273 STEP 24 
120 INPUT “ENTER SCALE ”;S 
130 IFS <1 THEN X = 273: GOTO 160 
140 IF S > 50 THEN X = 273: GOTO 160 
150 SCALE =$: DRAW 1 AT X,100 
160 NEXT X 
170 DATA 1,0,4,0,39,36,45,53,54,63,0 
180 END 


In the preceding example, line 20 initialized the screen so that 
graphics could be drawn. The shape table was then read using 
the FOR NEXT loop in lines 30 to 60. Line 80 POKE’d the starting 
address of the shape. Lines 90 and 100 defined a color and 
rotation for the shape. Lines 110 to 160 then prompted the user to 
enter ascale size. The number entered will be the size of the next 
shape drawn on the screen. The program will then exit after the 
entry of eleven sizes or when the value entered is less than one 
or greater than fifty. 


@® Applesoft 
SCRN @ Integer 


SCRN is used in the low resolution graphics mode to return the 
color code of the point specified as its argument. 
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Configuration 
SCRN (x,y) 


x and y can range from 0 to 47. If x is in the range from 0 to 39, 
SCRN will return the color code of the point whose column is 
indicated by x and whose row is indicated by y. 


If x is in the range from 40-47 and y is in the range from 0-31, 
SCRN will return the color of the point whose column is equal to 
x-40 and whose row is equal to y+16. 


If x isin the range from 40-47 and y+16 is in the range from 39-47, 
SCRN will return a number related to the text character in the 
text area before the graphics screen. If y+16is in the range 48-63, 
SCRN will return a meaningless number. 


When x is in the range 0-39 and y is in the range 0-23, the 
following expression will return the ASCII code of the character 
at that position. 


SCRN (a, 2*6) + 16*SCRN (a, 2*b+1) 


The character itself will be returned when the CHR$ function is 
executed using the value returned by the above expression as its 
argument. 


When SCRN is executed in the high resolution graphics mode, 
SCRN will continue evaluating the low resolution area of 
memory. The value returned by SCRN will have no relation to 
the high resolution screen. 


SCRN is only regarded as a reserved word when the next non- 
space character is the left parenthesis. 
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Example 


10 GR 

20 COLOR =2 

30 PLOT 20,10 

40 COLOR =6 

50 PLOT 30,35 

60 PRINT SCRN(20,10), SCRN(30,35), SCRN(10,0) 
70 END 


In the preceding example, line 10 initializes the low resolution 
screen. Lines 20 to 50 plot two different colored dots on the 
screen. Line 60 displays the color value of the corresponding 
dots. Notice that the value of SCRN(10,0) is zero. There is a black 
dot at that position. 


m Applesoft 
SGN @ Integer 





The SGN function returns a +1 if its argument is positive, a -1 if 
negative, and a 0 if zero. 


Configuration 
SGN (a) 
Example 


100 A =100 
200 X = SGN(A) 
300 PRINT X 
400 END 
JRUN [Ret] 

1 
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# Applesoft 
SHLOAD O Integer 


SHLOAD is used in Applesoft BASIC to load a high resolution 
shape table into memory from cassette tape. 


Configuration 
SHLOAD 
The shape table will be loaded in memory immediately below 
HIMEM. HIMEM will be set just underneath the shape table in 


order to protect it. 


Be certain that HIMEM: has been set so that the execution of 
SHLOAD will not erase any programs or variables. 


= Applesoft 
SIN O Integer 


The SIN function returns the sine of the angle specified as its 
argument. The argument will be assumed in radians. 


Configuration 
X = SIN (a) 
Example 


PRINT SIN (3.1415927/2) 
.999999992 
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= Applesoft 
SPC O Integer 


The SPC statement ts used to insert spaces in a PRINT statement. 
Configuration 
SPC (a) 


The argument of the SPC statement specifies the number of 
blank spaces that will occur. 


Example 


10 X=4 
20 Y =6 

30 PRINT X;SPC(5);Y 
40 END 

JRUN [Ret] 

4 6 


In the previous example, the values of the variables X and Y are 


printed at line 30. The SPC statement within the PRINT statement 
causes the output to be separated by 5 extra spaces. 


@ Applesoft 
SPEED O Integer 


The SPEED statement sets the speed at which characters are 
output. 


Configuration 
SPEED = x 


x can range from 0 to 255, with 0 being the slowest speed and 255 
the fastest. 
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@ Applesoft 
SQR O Integer 
SQR returns the square root of its argument. 
Configuration 
SQR (a) 
Example 
10 X =49 
20 PRINT SQR (X) 
JRUN [Ret] 
7 
@ Applesoft 
STOP O Integer 





The STOP statement causes a halt in the execution of an 
Applesoft BASIC program. 


Configuration 
STOP 


lf STOP is executed in the program mode, the following screen 
message will be displayed, 


BREAK IN XXX 
where XXX is line number where STOP was executed. 


CONT can be used to rescue program execution after it was 
halted by the execution of a STOP statement. 
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Example 


10 INPUT X 

20 IF X =10 THEN STOP 
30 PRINT X 

40 END 


In the preceding example, if a value of 10 is input for X in line 10, 
the program execution will stop and the following message will 
be displayed. 

BREAK IN 20 


By entering CONT, program execution will resume with line 30. 


@ Applesoft 
STORE O Integer 





The STORE statement is used to save an Applesoft array on 
cassette tape. STORE is generally used in conjunction with the 
RECALL statement. 

Configuration 


STORE array 


For an explanation of STORE please refer toRECALL on page 141. 


mg Applesoft 
STR$ 0 Integer 





STR$ returns the string representation of its argument. 
Configuration 


X$ = STR$(a) 
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Example 


10 A$ =STR$(40) 
20 PRINT A$ 

30 END 

JRUN [Ret] 

40 


In the preceding example, the string variable A$ is assigned the 
string value “40”. The STR$ function converts the numeric value 
40, to the string value "40". 


@ Applesoft 
TAB O Integer 


In Applesoft BASIC, the TAB function moves the cursor to the 
right to the column specified as its argument. TAB must be used 
with a PRINT statement in Applesoft BASIC 


Configuration 
TAB (column) 


TAB erases existing screen data as it moves to the right. If the 
specified column is not to the right of the current column 
position, the cursor will not move. 


column can range from 1 to 255. If column is greater than that 
allowed for the output device (80 for video display), the cursor 
will move down to the next output line before tabbing will 
continue, 
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10 X=1:Y =2 

20 PRINT 

30 PRINT X; 

40 PRINT TAB(120); 
50 PRINT Y 

60 END 


In the preceding example, X is output at the leftmost column of 
the display line. TAB then moves the current print position to the 
middle of the next display line where Y is output. In Applesoft 
the TAB statement after produces erratic results if itis not the first 
item in the PRINT statement output list. 


O Applesoft 
TAB @ integer 





In Integer BASIC, TAB positions the cursor at the specified 
column on the display line where the cursor is located. 


Configuration 

TAB column 
In Integer BASIC, the cursor will be moved to the left or right 
depending on the value of column and the current cursor 


position. column can range from 1 to 255. Existing screen data is 
not erased if TAB causes the cursor to move over that data. 


Example 
10 PRINT 
20 X=1:Y =2 
30 PRINT X:TAB 20:PRINT Y:TAB 10:PRINT Y 
40 END 
> RUN [Ret] 
1 

2 
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# Applesoft 
TAN O Integer 





TAN returns the tangent of its argument in radians. 
Configuration 
a = TAN(b) 
Example 


10 A = TAN(35*3.141593/180) 


20 PRINT A 
JRUN [Ret] 
.700207639 
w Applesoft 
TEXT m Integer 


TEXT returns the screen to the text mode from any of the 
graphics modes. 


Configuration 
TEXT 


TEXT does not necessarily clear the screen. 


w Applesoft 
TRACE w Integer 





TRACE displays the line number of each statement as it is 
executed. Generally, TRACE is used as a debugging tool. 
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Configuration 
TRACE 


TRACE can be turned off by executing NO TRACE. 


® Applesoft 
USR O Integer 


USR passes program control to a machine language subroutine. 
USR’s argument is evaluated and then placed in the floating 
point accumulator (9DH and A3H). A USR is then undertaken to 
OAH, which is the subroutine’s starting address. 


Addresses 0AH to OCH must contain aJMP to the starting address 
of the machine language subroutine. 


Since USR is a function, it returns a numeric value. The value in 
the accumulator is returned when an RTS instruction is executed. 


Example 


10 POKE 10,76 : POKE 11,0 : POKE 12,32 
20 FOR X = 8192 TO 8198 

30 READ V 

40 POKE X,V 

50 NEXT X 

60 FORX=1T04 

70 PRINT X, USR(X) 

80 NEXT X 

90 DATA 165,157,105,3,133,157,96 

100 END 


In the preceding example, line 10 pokes the location of the 
machine language program to be executed. Lines 20 to 40 place 
the program in memory. Lines 60 to 80 then make use of the 
machine language program. The USR in this example multiplies 
the argument by 16. 
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w Applesoft 
VAL O Integer 





The VAL function converts its string argument to a numeric 
value. The numeric characters in the string argument will be 
converted to their numeric equivalents until an unacceptable 
string character is encountered. The acceptable characters 
consist of the digits (0-9), the decimal! point, a leading plus or 
minus sign, blank spaces, and in scientific notation an additional 
plus or minus sign, the letter E (for exponent), and an additional 
decimal point. 


If the first character encountered by VAL is an unacceptable 
character, a value of zero is returned. 


Configuration 


VAL (a$) 


Example 


10 A$ ="1.731E+02” 
20 B$ ="+97.5” 

30 C$ ="57CA" 

35 D$ ="E59” 

40 PRINT VAL(A$) 

50 PRINT VAL(B$) 

60 PRINT VAL(C$) 

70 PRINT VAL(D$) 


JRUN [Ret] 
173.1 
97.5 
57 
0 
8 Applesoft 
VLIN m Integer 


VLIN is used to draw a vertical line in low-resolution graphics. 
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Configuration 
VLIN row 7, row 2 AT column 


A vertical line will be drawn at the specified column from row 7 
to row 2. The color of the line will be determined by that 
specified in the last COLOR statement executed. 


row 71 and row 2 must be in the range of 0 to 47. column must lie 
inthe range 0to 79. If a value outside of these ranges is used, the 
following error message will be displayed: 


ILLEGAL QUANTITY ERROR 


If VLIN is executed in the text mode, then a line of characters will 
be displayed rather than a line of graphics dots. This also occurs 
in the text window in the GR mode. 


Example 


10 GR 

12 COLOR = 3 

15 FORT =71 TO 20 
20 VLIN 10,30 AT | 
25 NEXT | 

30 END 


m Applesoft 
VTAB m Integer 


VTAB moves the cursor to the indicated row on the screen. VTAB 
causes the cursor to move up and down but never sideways. 


Configuration 
VTAB row 


row can range from 1 to 24. A row value outside of that range 
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results in the following error message: 
ILLEGAL QUANTITY ERROR 
Example 


5 HOME : REM CALL -936 
10 PRINT “ROW 1” 
20 VTAB 2:PRINT “ROW 2” 
30 VTAB 10:PRINT “ROW 10” 
40 VTAB 20:PRINT “ROW 20” 
50 END 


w Applesoft 
WAIT O Integer 





WAIT can be used to suspend operation of an Applesoft BASIC 
program until a designated memory address is assigned a 
specified value. 


Configuration 
WAIT address, value 7, [value 2] 


address specifies the memory address whose value is to be 
decided. value 7 and value 2 are compared with address to 
determine whether the program proceeds or continues to wait. 


address can range from -—65535 to 65535. value 7 and value 2 can 
range from 0 to 255. When WAIT is executed, value 7 and value 2 
are converted to their binary equivalent in the range from 0 
through 11111111. 


When address and value 7 are the only arguments indicated with 
WAIT, each of the eight bits in address are AND’ed with each 
corresponding bit in the binary equivalent of value 7. If the result 
of the AND operation is non-zero for any one bit (the bit had a 
value of 1 in both address and value 71), the WAIT statement will 
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be completed and execution will be resumed. Otherwise, this 
test will continue until a non-zero value is returned. 


When value 2 is also specified, a two-part comparison process is 
used. First of all, each of the eight bits at address are XOR’ed with 
the corresponding bit in value 2’s binary equivalent. Second, the 
result of the XOR comparison is AND’ed with the corresponding 
bit in value 1’s binary equivalent. If a non-zero value is returned 
for any comparison, the program will proceed. Otherwise, the 
test will continue. 


Example 


10 REM SET ADDRESS FOR GAME CONTROL 0 TO 0 
20 POKE 49168,0 
30 PRINT “THE PROGRAM HAS STARTED” 
40 PRINT:PRINT 
50 PRINT “EXECUTION WILL BE HALTED UNTIL 
THE BUTTON ON GAME CONTROL 0 IS PRESSED” 
60 PRINT:PRINT 
70 WAIT ~16287,128 
80 PRINT “THE BUTTON WAS PRESSED" 
90 PRINT “THE PROGRAM WILL NOW END” 


= Applesoft 
XDRAW O Integer 


XDRAW is used to draw a graphics shape in high resolution 
graphics. 


Configuration 
XDRAW shape [AT column, row] 
The color, scale, and rotation of the shape to be drawn must have 


been specified previously. shape denotes the number from the 
shape table of the shape to be drawn. shape must have a value 
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between 0 and the number of shapes in the table. The optional 
column and row denote the starting x and y coordinates for the 
shape. 


XDRAW uses the color which is the compliment of the color 
which already exists at each point being plotted. The com- 
plementary colors are as follows: 


O(Black} — 3(White) 
1(Green) — 2(Violet) 
4(Black) — 7(White) 
5(Orange) — 6(Blue) 


One other feature of XDRAW is that it allows a shape to be easily 
erased. If ashape is XDRAWn and then XDRAWn again with the 
same parameters, the shape will be erased without erasing the 
background. 


Example 


10 REM SET UP SCREEN 
20 TEXT:HGR 
30 FOR X =7936 TO 7946 
40 READ V:REM READ IN SHAPE 
50 POKE X,V:REM POKE SHAPE INTO MEMORY 
60 NEXT X 
70 REM TELL WHERE SHAPE IS AT 
80 POKE 232,0:POKE 233,31 
90 REM PUT UP A BACKGROUND 
100 HCOLOR = 3 
110 HPLOT 20,20 TO 60,20 TO 20,70 
120 PRINT “BACKGROUND SET UP” 
130 INPUT “PRESS RETURN TO DISPLAY SHAPES”; A$ 
140 ROT =0 
150 SCALE = 10 
160 XDRAW 1 AT 50,30 
170 SCALE =6 
180 ROT =4 
190 XDRAW 1 AT 20,70 


program continued on next page 
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200 INPUT “PRESS RETURN TO ERASE SHAPES”; A$ 
210 XDRAW 1 AT 20,70 

220 SCALE = 10 

230 ROT =0 

240 XDRAW 1 AT 50,30 

250 DATA 1,0,4,0,39,36,45,53,54,63,0 

260 END 


In the preceding example, line 20 initialized the screen so that 
graphics could be drawn. The shape is then read in the FOR 
NEXT loop in lines 30 to 60. Since Applesoft needs te know where 
the shape was placed, the shape address is POKE’d into memory 
in line 80. 


A color is defined in line 100. The color definition is only 
necessary for the background, which consists of two lines. 
XDRAW does not need to define the color, however the size and 
the rotation should be defined. These are defined on lines 140, 
150, 170, 180, 220 and 230. 


The two shapes, with different sizes, rotations, and positions, are 
then XDRAW’n to the screen in lines 160 and 190. Notice that the 
shapes were drawn over the background (two lines). The two 
shapes were then drawn again over the previous shapes in lines 
210 and 240. Because XDRAW plots the compliment of the color 
that is on the screen, it will erase the previous shape and keep the 
background intact. 


CHAPTER 5. CASSETTE AND DISK 
STORAGE WITH THE APPLE lle 





Introduction 


Generally, a disk drive is used for storage with the Apple Ile. 
However, a cassette recorder can also be used with the Ile for 
data storage. In this chapter, we will discuss cassette storage 
procedures followed by disk storage procedures. 


If you are using the cassette recorder rather than the disk unit for 
data storage, keep the following points in mind: 


@ DOS is not available when using the cassette. 
Applesoft and the Monitor are the only 
available systems software. 


@ Since Integer BASIC is loaded from diskette, it is 
not available on cassette. Therefore, Integer 
BASIC programs cannot be loaded and run 
from cassette. 


CASSETTE INSTALLATION & OPERATION 


Nearly any standard cassette recorder can be used with the lle. 
The cassette unit is installed by attaching a double cable (or two 
individual cables) from the cassette in and out jacks at the rear of 
the Ile to the jacks on the cassette recorder. One cable should 
connect the cassette input jack on the Ile to the earphone or 
monitor jack on the cassette recorder. The other cable should 
connect the Ile’s cassette output jack to the cassette recorder’s 
microphone jack. 


The cassette unit is operated in much the same manner with the 
lle to record data as it is used to record sound. The play and 
record keys must be depressed to save data on the cassette. The 
play key must be depressed when data is to be read from the 
cassette into RAM. The rewind and fast forward keys are used to 
position the tape. 
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You may find it necessary to adjust the tone and volume controls 
in order for the cassette to properly record data. The easiest 
means of doing this is to try saving and reloading a program. If 
the program can be saved and then reloaded without any 
difficulties, the volume and tone controls are adjusted properly. 
If one of the following error messages appears: 


ERR 
***SYNTAX ERR 


set the volume control higher and again attempt the saving and 
loading process. 


SAVING & LOADING A PROGRAM ON CASSETTE 


The SAVE command is used to save a program from RAM to the 
cassette recorder. Prior to executing SAVE, be certain that a 
cassette has been placed in the cassette recorder and that the 
tape has been positioned as desired. Then, press the recorder’s 
play and record keys and enter the following command at the 
keyboard: 


SAVE [Ret]* 
The Apple He will beep once as it begins recording the program 
on tape, and will beep asecond time when the recording process 


has been completed. After the second beep, press the recorder’s 
stop key. 


*[Ret] indicates that the return key should be pressed. 
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If you wish to load a program from cassette tape into RAM, first 
of all enter NEW in order to erase any existing program lines 
from memory. Be certain that the tape has been rewound to the 
beginning point of the program to be loaded. Press the re- 
corder’s play key, and enter the following command: 


LOAD 


The Apple Ile will beep once as the loading process begins anda 
second time when it ends. After the second beep, press the 
recorder’s stop key. You can verify the fact that the program has 
been loaded by executing LIST. 


Storing & Loading Data on Cassette 


Numeric arrays can be stored and loaded on cassette using 
Applesoft’s STORE and RECALL statements. These are discussed 
in detail in Chapter 4. 


The Monitor’s memory write and memory read commands can 
also be used to store and read data to and from tape. These will 
be discussed in detail in Chapter 7. 


Apple Ile Disk Storage 


A disk drive can also be used with the Apple Ile to store data 
and/or programs. Disk storage is much more efficient than 
cassette tape storage. The majority of Ile owners are expected to 
use disk drives as their primary means of data storage. 


TYPES OF DISKS 

There are three primary types of disks used by personal 
computers; hard disks, Winchester disks, and floppy diskettes. 
Thes+ will be described in the following sections. 


Hard Disks 


Microcomputer hard disk systems generally allow storage of 5 to 
30 megabytes of data. One megabyte is the equivalent of one 
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million bytes. The hard disk itself is made of a rigid material with 
a magnetic coating. The disk drive and the hard disk are separate 
units. The operator can remove one hard disk and replace it with 
another. 


Winchester Disk Drives 


Winchester disk drives are designed so that from 6 to 10 times 
more data can be stored on their surface than on a standard 
floppy diskette. Winchester disks must be kept very clean as they 
are extremely vulnerable to dust, dirt and smoke. 


Since they must be kept so clean, Winchester disks must be 
sealed inside of the disk drive. This means that Winchester disks 
cannot be changed. 


Since Winchester disks cannot be removed, floppy disk systems 
often are used in conjunction with Winchester disks to allow for 
back-up storage. Winchester disk systems are generally used 
with microcomputers rather than hard disk systems. A Win- 
chester drive is shown in Illustration 5-1, 
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Illustration 5-1. Winchester Disk System 





Floppy Diskettes 


The most widely used type of disk storage with microcomputers 
is floppy disk storage. The Disk II Drive (used with the Ile) is a 
floppy disk drive. A floppy diskette consists of around vinyl disk 
which is enclosed within a plastic cover. The diskette is generally 
stored in a diskette envelope. 


This cover protects the diskette from damage while it is being 
handled by the operator. The diskette should never be removed 
from its cover. A 5% inch diskette with its protective envelope is 
shown in Illustration 5-2. 


The diskette is allowed to rotate within the protective envelope. 
The round hole in the middle of the diskette allows the disk drive 
to hold the diskette and spin it. The oblong shaped opening on 
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the protective envelope provides an area where the head can 
read from or write to the diskette surface. 


Illustration 5-2. Mini-Floppy Diskette 





Floppy diskettes come in two sizes: 8 inch and 5% inch. The 5% 
inch diskettes are also known as mini-floppy diskettes. Apple’s 
Disk II drives use mini-floppy diskettes. 


Tracks and Sectors 


To facilitate the process of searching for data on the diskette 
surface, that surface is divided into tracks and sectors. 


Tracks may be visualized as a series of concentric circles on the 
diskette surface, as shown in Illustration 5-3. 
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INustration 5-3. Tracks and Sectors 





In Apple’s Disk II system, the diskette is divided into 35 different 
tracks. 


To further reduce the time necessary to search for a particular 
data item, Apple’s DOS* divides each track into 16 sectors (see 
Nlustration 5-3.) 


Each sector can store up to 256 bytes of information. When the 
Disk Il’s read/write head* is in place over a specific track, that 
track’s 16 sectors will pass one by one underneath the read/write 
head as the diskette rotates. 


Whenever DOS reads or writes information from the diskette, it 
does so in groups of 256 bytes. In other words, data is read from 
or written to the diskette one sector at a time. 


*DOS stands for disk operating system which will be explained in 
detail later. 
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Hard and Soft Sectoring 


Locating a particular track on the disk surface is a relatively 
uncomplicated matter. The drive merely moves the head to the 
position on the diskette where the specified track is located, 
much like the needle on a phonograph is positioned to the 
location of a specific song on a record album. 


However, locating a particular sector is a more difficult process. 
Two different methods are used to locate sectors on a disk; hard 
sectoring and soft sectoring. 


Both the hard and soft sector methods involve the use of an 
index hole. The index hole is shown in Illustration 5-2. It is 
located just to the right of the large hole in the middle of the 5% 
inch diskette. 


The index hole as shown in Illustration 5-2 is a hole only in the 
diskette’s protective covering. Another index hole is located on 
the actual diskette surface inside the envelope. As the diskette 
spins, the index hole (or holes) on the diskette surface passes 
underneath the hole in the protective envelope. 


A light source inside the disk drive shines light onto the area of 
the diskette containing the index hole. When an index hole on 
the disk surface is aligned with the index hole on the protective 
envelope, the light will shine through to a sensor. The sensor will 
relay information on the location of the index holes, which can 
be used to calculate the various sector locations. 


Now that we have discussed the concepts of locating sectors, we 
will discuss the difference between hard and soft sectored 
diskettes. A hard sectored diskette contains a number of holes, 
each of which indicates the location of a sector. An extra hole is 
used to indicate the location of the first sector. The location of 





*The disk drive contains a device known as a read/write head, 
which is used to read and write information. The computer can 
move the head to any position desired on the disk surface. 
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the various sectors is determined by counting the number of 
holes occuring after the first sector. A hard sectored diskette is 
depicted in Illustration 5-4. 


Soft sectored diskettes have only one index hole as shown in 
Illustration 5-5. This solitary index hole marks the location of the 
first sector. By timing the rotation speed of the floppy diskette, 
the location of the other sectors can be determined. The Apple 
lle Disk System uses soft-sectored diskettes. 


Illustration 5-4. Hard Sectored Diskette 





2 Index Holes 


Sector 


illustration 5-5. Soft Sectored Diskette 


Index Hole 


Sector 
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Single and Double Sided Diskettes 


Some floppy diskettes are designed to be written on only one 
side. These are known as single sided (SS) diskettes. 


Diskettes which are designed to be written on both sides are 
known as double sided (DS) diskettes. 


Single, Double, and Quad Density Diskettes 


Density refers to a diskette’s recording format, which in turn 
affects its capacity. Double density diskettes generally have a 
greater recording capacity than single density diskettes, while 
quad density diskettes generally have a greater capacity than 
either single or double. 


The Apple Ile Disk Drive uses double-density diskettes with a 
capacity of 143,250 bytes. 


Diskette Write Protection. 


Diskettes have a notch on the side of their protective envelope 
which determines whether or not data can be written onto that 
diskette. On 8 inch diskettes, this notch is known as a write- 
protect notch. On 5% inch diskettes, it is known as a write- 
enable notch. 


On a 8 inch diskette, information cannot be written onto the 
diskette unless this notch has been covered. On 5% inch 
diskettes, information cannot be written onto the diskette unless 
the notch is left uncovered. 


Some 5% inch diskettes (especially system diskettes) may be 
permanently write protected if their protective envelope does 
not contain a notch. Any 5% inch diskette with a notch can be 
write protected by merely covering the notch with a piece of 
tape as shown in Illustration 5-6. 
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Illustration 5-6. Write Protecting a 5% inch Diskette 





Diskette Handling Rules 


Diskettes are easily damaged. Therefore, certain rules should be 
observed when handling or storing diskettes. 


First of all, keep your diskettes clear of magnetic fields. Most 
devices with electric motors contain magnetic fields as do most 
telephones. Keep your diskettes clear of appliances with electric 
motors and telephones. However, it is safe to place diskettes on 
top of the Ile or the Disk II unit. 


When writing on a diskette label, do so only with a felt tip pen. 
Never use a pencil or a ball point pen. Doing so can damage the 
diskette surface. 


Exposure to the sun or to extreme heat can cause diskettes to 
warp. Be certain to keep your diskettes out of direct sunlight and 
away from heat sources. 
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Never touch the actual exposed surface (brown or grey) of the 
diskette. Handle only the diskette’s black plastic cover. A 
scratch, fingerprint, dirt, or grease mark can cause a loss of data. 


Inserting and Removing a Diskette 


Before a diskette can be inserted, the drive door must be 
opened. This is accomplished by gently pulling outward on the 
drive door lever. 


The diskette is inserted into the drive with its label facing 
upwards, as shown in Illustration 5-7. Slide the diskette gently 
into the device until it clicks into place and then close the drive 
door. 


To remove a diskette, merely open the drive door and gently pull 
the diskette out of the drive. 


Illustration 5-7. Inserting a Diskette 
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DISK OPERATING SYSTEMS 


An operating system can be defined as a group of programs 
which manage the computer’s operation. A disk operating 
system can be defined as a group of programs that manage the 
transfer of data to and from a storage device such as disk or 
magnetic tape. 


The standard operating system provided with an Apple Ile with a 
Disk Drive Il is Apple DOS 3.3 (referred to simply as DOS). Other 
operating systems such as PASCAL and CP/M are also available 
for the Apple Ile. 


Apple’s DOS will be discussed in detail in this chapter. 
DISK Il SYSTEM 


The name of the floppy disk drive used by the Apple Ile is the 
Disk tI. The Disk II system includes the disk drive (see Illustration 
5-8), disk controller card (see Illustration 5-9), a cable used to 
connect the disk controller card to the disk drive (see Illustration 
5-9), a System Master diskette, and a BASICS diskette. 


Installing The Disk II System 


First of all, open the rectangular opening labeled 1 on the rear of 
the Ile. Next, insert the free end of the cable connected to the 
Disk Il through this opening. 


Locate one of the U-shaped clamps and two jack screws (see 
Illustration 5-10). Find the metal bar on the cable. Open the 
clamp slightly and slide it over the cable and the metal bar. The 
flat side of the clamp should be positioned against the cable. The 
raised side of the clamp should be positioned against the metal 
bar. Feed the cable through rectangular opening #1 until the 
clamp can be placed in the opening. Position the clamp in the 
opening, and install the jack screws into the nuts on the clamp. 
Tighten the screws with a small wrench.(See Illustration 5-11.) 
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illustration 5-8. Disk II Drive 





Illustration 5-9. Disk Contoller Card and Cable 
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Illustration 5-10. Inserting Clamp over Cable and Metal Flap 





Illustration 5-11. Installing the Clamp on the Rear 
of the Apple Ile 
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Next, install the cable from drive 1 to the pins labeled DRIVE 1 on 
the disk drive controller card. (See Illustration 5-12.) 


Be sure to install the disk drive cable into the controller card 
before the card has itself been installed in the Apple Ile. Doing 
otherwise could result in damage. 


Also, be certain that the disk cable connector has been properly 
inserted into the pins on the controller card. A faulty connection 
can result in damage. 


Illustration 5-12. Installing the Disk Drive 
Cable to the Disk Controller Card. 
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Once the disk cable connectors have been properly connected 
to the disk controller card, the installation of the Disk I system 
can be completed by merely plugging the controller card into 
slot 6. 


Before installing the disk controller card (or any other card), be 
certain that the power switch at the back of the Ile is off. If the 
power is on when a card is installed or removed, damage could 
result to the card, the Ile, or to both. 


If you wish to install a second drive, follow the same procedure 
except insert the disk drive cable through opening #2 on the rear 
of the Ile, and attach the disk drive cable to the pins labeled 
DRIVE 2 on the disk controller card. 


If you wish to install a third or fourth drive, a second disk 
controller card will have to be installed in slot 4. Insert the drive 
cables through openings 3 and 4 on the Ile’s rear panel. The 
cable connector for drive 3 should be installed on the pins 
labeled DRIVE 1 on this disk controller card. The cable connector 
for drive 4 should be installed on the pins labeled DRIVE 2 on this 
card. 


If you are installing more than one drive, it isa good idea to label 
your drives so as to prevent possible confusion. Remember that 
DOS must be booted from drive 1. 


BOOTING DOS 


There are several different methods of booting DOS on the 
Apple Ile depending upon how your Ile system is configured as 
well as from which language DOS is being booted. 


Autostart Boot 


The autostart boot is the easiest method of booting DOS 3.3. 
With the Apple Ile powered off, place the System Master 
Diskette in drive 1 and close the drive door. Then, turn the Ile’s 
power on. The disk will spin for a few seconds and then stop. The 
screen display will resemble that depicted in Illustration 5-13. 
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Booting from Integer or Applesoft BASIC 


The prompt character for Integer BASIC is the greater than sign 
(>). The prompt for Applesoft BASIC is the left bracket (]). The 
same commands can be used to boot DOS from either Integer or 
Applesoft BASIC. This command consists of the letters IN or PR 
followed by the pound sign (#) and the slot number containing 
the controller card (generally (6). The boot command should 
resemble one of the following: 


PR#6 
IN#6 


Once the boot command has been entered, press the return key. 
Again, the drive will spin for several seconds, afterwhich the 
screen display depicted in Illustration 5-13 will appear. 


illustration 5-13. DOS Start-up Screen Display 


APPLE II 
DOS VERSION 3.3 SYSTEM MASTER 
JANUARY 1, 1983 


COPYRIGHT APPLE COMPUTER, INC. 
1980, 1982 
BE SURE CAPS LOCK IS DOWN 





Booting from the Monitor 


The asterisk (*) is the prompt for the assembly language monitor. 
One method of booting DOS from the monitor is to enter the 
following command and press return. 


* C600G 


This causes DOS to be booted from drive 1 (assuming the disk 
controller card was installed in slot 6.) 
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Another method for booting DOS from the monitor ts to enter 
the slot number of the drive to be booted from (generally 6) 
followed by Ctrl-P and Return. 


Restarting DOS 


If the computer is already powered on, and you wish to restart 
the System using DOS, you can do so by as follows: 


1. Insert the DOS diskette in drive 1. 

2. Hold down the Open Apple key simultaneously with Ctrl- 
Reset. Release Ctrl-Reset and then release the Open Apple 
key. 

3. The computer will beep. The drive’s in-use light will come on 
and the drive will begin spinning. 

4. When DOS has been loaded, the drive will stop and the DOS 
initial screen display will appear on the screen. 


Booting DOS Conclusion 


Once you have booted DOS, you will still be able to execute 
most of your BASIC commands in the same fashion as if DOS had 
not been booted. A few BASIC commands will have additional 
capabilities under DOS. You will also have the option of 
executing DOS commands. 


This is not the case in other operating systems such as CP/M 
where DOS commands cannot be entered when BASIC is active 
and vice versa. 


Using 13-Sector Diskettes 


While DOS 3.3 initializes diskettes with 16 sectors per track, the 
earlier verison of DOS (3.21 and 3.2) used diskettes with 13 
sectors. The 13 sector diskettes can be run under DOS 3.3 by 
using the BASICS diskette rather than the System Master in the 
loading process. A prompt will appear instructing you to load 
your 13 sector diskette. Remove the BASICS diskette, insert the 
13 sector diskette, and press return. You can now use the 13 
sector diskette. 


You can also convert 13 sector diskettes to 16 sector by using the 
CONVERT13 program located on the System Master. CON- 
VERT13 does not actually change the diskette’s format, but 
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instead copies tiles from the 13-sector diskette onto a 16-sector 
diskette (previously initialized for 16 sectors using INIT under 
DOS 3.3). 


Upon running the program (by executing RUN CONVERT13), a 
menu will appear on the screen. Option 1 starts the conversion 
process. You will be prompted for the source and destination 
slot and drive numbers as will as the filename. You should then 
insert the diskette per your prompt response and press any key to 
begin. Continue this process until all desired tiles on the 13 
sector diskette have been transterred. When the process has 
been completed, you can reintialize the old 13 sector diskette 
under DOS 3.3 tor use as a 16 sector diskette. 


A copy-protected 13-sector disk can also be used under DOS 3.3 
by pertorming a two-disk startup. First of all, place the DOS 3.3 
System Master in drive 1, close the drive door, and restart the 
system. Then, enter the following command: 


RUN START13 


The following will appear: 
Slot to boot from (DEFAULT = 6) 


Place the 13-sector diskette tn drive 1 and press return if your 
disk controller card was installed in slot 6. Otherwise, enter the 
number ot the slot where the controller card was installed. 


Prompts 


Once DOS 3.3 has been loaded, either DOS, Integer BASIC, or 
Applesoft BASIC commands can be entered. The prompt dis- 
played on the screen indicates to the user which commands the 
lle will accept. When the Applesoft prompt ( ] ) is displayed, 
either Applesoft BASIC or DOS commands can be entered. 
When the Integer BASIC prompt is displayed (>), either Integer 
BASIC or DOS commands can be entered. 


DOS does not have its own prompt. You can check whether or 
not DOS has been loaded by entering a DOS command. If the 
command works, DOS has been loaded. If the command does 
not work, DOS has not been loaded with the Ile, DOS is loaded 
during start-up. 
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Error Message Format -- DOS, Applesoft, Interger 


If an incorrect command is entered, an error message will be 
generated. The format of the error message will indicate 
whether that error was generated by DOS, Integer BASIC, or 
Applesoft BASIC. 


If a question mark precedes the error message, the error was 
generated by Applesoft BASIC as indicated in the following 
example: 


? SYNTAX ERROR ~—Applesoft BASIC 


If three asterisks precede the error message, the error was 
generated by Integer BASIC as shown below: 


*** SYNTAX ERROR~— Integer Basic 
If no prefix precedes the error message, it was generated by 
DOS. The following error message would be displayed under 
DOS: 
SYNTAX ERROR~— DOS 
DOS COMMANDS 


In the following sections we will discuss the usage of the various 
Apple DOS commands. These include: 


APPEND INIT READ 
BLOAD LOAD RENAME 
BRUN LOCK RUN 
BSAVE MAXFILES SAVE 
CATALOG MON UNLOCK 
CLOSE NOMON VERIFY 
DELETE OPEN WRITE 


EXEC POSITION 
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Before discussing the individual commands, we will discuss 
topics related to all of these commands. These topics include: 


Filenames 

Drive Number Specification 
Slot Number Specification 
Volume Specification 


Filenames 
In Apple’s DOS, a file must be referenced using its filename. 


DOS filenames must adhere to certain rules. First of all, a 
filename must be from 1 to 30 characters in length. Any characters 
in excess of 30 will be dropped (or truncated). The first character 
of the filename must be a letter. Any keyboard character except 
the comma can be used in a filename. 


Control characters can be included in filenames, although they 
will not be displayed in catalog listings as they are nonprinting 
characters. For example, the following filename: 


TEXT T Tindicates pressing the Control key 


would be displayed as TEXT in the catalog listing. However, if an 
attempt was made to load the file using the filename TEXT, DOS 
would not be able to locate the file. 


Using control characters within filenames offers an effective 
security measure, as others will not be able to identify the actual 
filename. 


Drive Specification 

Generally, DOS commands allow the user to specify several 
optional parameters including the diskette’s volume nurnber, 
the slot containing the disk controller, and the disk drive being 


used. 


Each disk controller can control two separate disk drives. If a disk 
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drive is not specified in a DOS command, that command will 
affect the diskette in drive 1. In other words, drive 1 is the default 
drive. 


If you wish the command to affect drive 2, end the command 
with a comma followed by D2. The following command would 
result in the directory for the diskette in drive 2 being displayed: 


CATALOG, D2 


Once D2 has been specified, all subsequent DOS commands will 
affect the diskette in drive 2. In other words, drive 2 will now be 
the default drive. 


If you wish to change the drive affected by DOS commands back 
to drive 1, merely end your DOS command with a comma 
followed by D1. The default drive will then be drive 1. 


Slot Specification 


If you wish to use more than two drives with your Ile, an 
additional controller card must be installed in one of the Ile’s 
expansion slots. Generally, the second controller card is installed 
in slot 4. Again two drives can be connected to this second 
controller card. 


If you wish to reference drives 3 and 4, you must use a second 
parameter known as a slot parameter. You cannot reference 
these drives as D3 and D4. 


The slot parameter follows the DOS command just like the drive 
parameter. The slot parameter must be separated from the DOS 
command or drive parameter with a comma. The slot parameter 
consists of the letter S followed by the slot number containing 
the disk controller to be accessed. 


The DOS command and any filenames must be specified first in 
the command. However, the order of the parameters (drive slot) 
is not critical. 
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For example, the following DOS command: 
CATALOG,S4,D2 


would acces the second drive installed on the controller card 
installed in slot 4. 


The default slot number will initially be the slot from which DOS 
was booted. Regardless of the slot used to boot DOS, DOS must 
always be booted from drive 1 rather than drive 2. If a slot 
parameter is subsequently executed, the specified slot will be 
the new default. 


When using the slot parameter with DOS commands, be certain 
that the specified slot contains a disk controller card. The follow- 
ing error will appear if the specified slot does not contain a disk 
controller card. 


I/O ERROR 


DOS will then suppose that the specified drive (which is in fact 
not connected to the system) is still running. DOS will wait for 
this non-existent controller and drive to signal that it has stopped 
running. In other words, DOS will be locked up even if the 
correct slot is specified. 


lf you do not care to save the program in memory, recovery from 
this error condition can be attained by simply pressing Reset. If 
you wish to save the program in RAM, you can do so by resetting 
the default slot parameter to the correct slot number. You can do 
so by entering: 

CATALOG, Sx 
where x is a valid slot number. 


Volume Specification 


A volume number can be assigned to a diskette when it is 
initialized. The volume number is specified during initialization 
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using the following configuration: 
Vx 
where x can be any integer from 1 to 254. 


If we wished to initialize a diskette in drive 2 attached to the 
controller slot 4 using the name “BEGIN” for the greetings* 
program, we could do so by issuing the following command: 


** INIT BEGIN, $4, D2, V100 


This command would assign the diskette a volume number of 
100. The volume number cannot be changed unless the diskette 
is reinitialized. 


Again, the order of the disk, slot, and volume specifications is not 
important. If a volume specification is not indicated, the diskette 
will be assigned a volume number of 254. 


If the volume number is specified with a DOS command, DOS 
will check the diskette’s volume number to be sure that it 
corresponds with the volume number indicated with the DOS 
command's V parameter. If you inadvertently specify the wrong 
volume number or insert the wrong diskette, the following error 
message will be displayed: 


VOLUME MISMATCH 


The use of the volume specification can prevent a diskette from 
accidentally being overwritten. 


The DOS CATALOG command ignores the volume specification. 
The volume number is displayed in the catalog listing. 





* — This program is run when the diskette is booted. 
** INIT will be discussed in detail later in this chapter. 
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Syntax 


We will use the following syntax rules in our discussion of DOS 
commands. 


DOS commands indicated in uppercase characters. 
DOS User Specified indicated in lower-case italics. 
Parameters 

filename indicates a filename. 

D indicates the drive specifier (1 or 2). 
S indicates the slot number (1-7). 

V indicates the volume number (1-254). 


These syntax conventions will be followed in the configuration 
section for each DOS command. 


CATALOG - Examining the Diskette’s Directory 


A diskette can contain a number of different programs or data 
files. Each file generates a listing in the diskette’s directory. A 
diskette directory can be defined as a file on the diskette 
containing information relating to all other files stored on that 
diskette. A directory is also often referred to as a catalog. 


The directory in Apple DOS can hold up to 105 tile entries. The 
directory is stored on track 17 of the diskette, with the first entry 
insector 15 and the last tn sector 1. Each directory entry includes 
the filename, tile type, number of sectors (mod 256) used by the 
file, and the location of the file’s track sector list. 


The CATALOG command can be used to display a diskette’s 
directory. Merely enter CATALOG and press return and a listing 
similar to that in illustration 5-14 will appear. If your screen fills 
with entries and the flashing cursor appears at the bottom of the 
screen, only a portion ot the directory was displayed. Press any 
key to continue the listing. When prompt appears (]), the listing 
will have been completed. 
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Hlustration 5-14. CATALOG Listing (System Master Diskette) 


] CATALOG 
DISK VOLUME 254 


*A 
*| 
‘T 
*| 
*| 
*| 
*B 
*A 
*B 
*| 
*A 
*| 
*B 
*A 
*A 
*B 
*B 
*B 


006 
018 
003 
006 
026 
017 
010 
006 
003 
009 
009 
009 
003 
009 
010 
020 
050 
050 





HELLO 
ANIMALS 
APPLE PROMS 
APPLESOFT 
APPLEVISION 
BIO RHYTHM 
BOOT13 
BRIAN’S THEME 
CHAIR 

COLOR DEMO 
COLOR DEMOSOFT 
COPY 
COPY.OB] 0 
COPYA 

EXEC DEMO 
FID 

FPBASIC 
INTBASIC 


Notice the first entry in the catalog listing is the disk volume 


number. 


Each file on the diskette contains a separate listing. This listing 
identifies the type of data contained in the file, whether or not 
the file is locked, the number of diskette sectors used by the file, 
and the *filename. 


*Filenames are discussed in the next section. 
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The one-letter code to the left of the listing identifies the file 
type. An A indicates an Applesoft program file, while | identifies 
an Integer BASIC program file. A T indicates a text file, and a B 
identifies a binary image file. 


If a file is locked, its type code will be preceded by an asterisk (*). 
If no asterisk appears, the file is unlocked. The concept of locked 
and unlocked files will be discussed later in this chapter. 


The number of sectors occupied by the file is displayed as a 
3-digit number to the right of the file type. For example, from 
Hlustration 5-14, HELLO occupies 6 sectors. 


The minimum size of a diskette file is 1 sector. If a file exceeds 255 
sectors, the sector catalogue listing number will be reset to zero 
at 255 sectors. For example, a file with 287 sectors would be 
displayed as 032 in the catalog listing. 


Track/Sector List 


One item also contained in the directory entry for a file (but not 
displayed by a CATALOG listing) is the location of the sector that 
contains that file's track/sector list. 


A track/sector list consists of a list of the diskette locations used 
by the file. The contents of a track/sector list are summarized in 
Table 5-1. 


If the track /sector list extends beyond 122 file sector identifiers, 
the links will point to one or more subsequent sectors of the 
track/sector list. Otherwise, the links will be set to 0. 
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Table 5-1. Track/Sector List 


Byte Contents 


Unused 


Link: Contains track number where track/sector 
list is continued. 


Link: Contains sector number where track/ 
sector list is continued. If both link bytes = 
0, the track/sector list is not continued. 


Unused 


Sector base number (identifies groups of 122 
sectors). 


Unused 

Track No. of First Sector in File 
Sector No. of First Sector in File 
Track No. of Second Sector in File 
Sector No. of Second Sector in File 
Track No. of Third Sector in File 


Sector No. of Third Sector in File 


(Continuation) 
Track No. of 122nd Sector in File 


Sector No. of 122nd Sector in File 





INIT 


Before a diskette can be written to, it must first be initialized. 
When a diskette is initialized, any existing data on the diskette is 
erased, DOS its copied to the diskette, and any program in 
memory Is copied to the diskette. 


The program copied should be the greetings program. This is the 
program which is automatically run when the diskette is booted. 


198 Apple Ile Users Handbook 


The greetings program generally is assigned the filename HELLO, 
however, any filename can be used. 


Configuration 
INIT filename* [Sx, Vx, Dx] 


filename refers to the name assigned to the greetings program 
(generally HELLO). S, V, and D are the slot, volume, and drive 
identifiers respectively. 


The first step in initializing a diskette is to boot DOS. Once DOS 
has been booted, remove the System Master Diskette from drive 
1 and replace it with the diskette to be initialized. Then, type 
NEW to clear the memory, and key in your greetings program. 


The following ts a typical greetings program: 


REM GREETINGS PROGRAM 1 
PRINT “SLAVE DISKETTE-DOS 3.3 64K SYSTEM” 


PRINT “JW--JULY, 28, 1983” 
END 





The following information should be included in the greetings 
program: 





* filename is generally HELLO. 
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@ Whether the diskette is a slave* or master* 
@ Size of the System on which the diskette was created 
@ Date on which the diskette was initialized 


Once the greetings program has been entered, enter the 
following command: 


INIT HELLO 


After the INIT command has been entered, press the return key. 
The disk will spin for about a minute as the diskette is being 
initialized. When the initialization process has been completed, 
the Applesoft prompt (] ) will be displayed. 


Finally, try booting your newly initialized diskette. Upon booting, 
the messages specified in your greetings program should appear 
on the screen. 


Master and Slave Diskettes 


INIT initializes a diskette as a slave diskette. A slave diskette’s 
DOS is memory size dependent. i.e. the diskette commonly can 
be used ona system with the same amount of RAM as the system 
on which the diskette was created. 


A slave diskette can be converted to a master diskette by using 
the MASTER CREATE program on your System Master diskette. A 
master diskette’s DOS is self-relocating. This allows memory to 
be allocated more efficiently. 


The following procedure should be followed to convert a slave 
diskette to a master. 


Step1: Insert the slave diskette into the drive and run the greet- 
Ings program. 





*Discussed later in this section. 
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Step 2: Edit the greetings program so that the initial message 
displayed by that program indicates that the diskette is a 
master. Then, save* the edited greetings program on 
the slave diskette. 


Step 3: If you plan on changing the name of the greetings 
program (see the prompt on the display in Step 5), use* 


RENAME at this point to change the program’s name. 


Step 4: Remove the slave diskette and replace it with the System 
Master. 


Step5: Boot DOS fromthe System Master and enter the follow- 
ing command from either Appilesoft or Integer: 


BRUN MASTER CREATE 


The following screen display will then appear: 






DOS 3.3 MASTER-CREATE UTILITY 





COPYRIGHT 1980 BY APPLE COMPUTER INC. 
ALL RIGHTS RESERVED 






(NOW LOADING DOS IMAGE} 






PLEASE INPUT THE GREETING PROGRAM'S 
FILE NAME: 






Step6: Enterthe program name used for the greetings program 
on the slave diskette (generally HELLO) and press the 
return key. The following screen will then appear: 


*The procedure for saving programs and renaming files will be 
discussed later in this chapter. 
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REMEMBER THAT MASTER DOES NOT CREATE 
THE GREETINGS PROGRAM, OR PLACE IT IN THE 
DISK DIRECTORY 
THIS (8S THE FILE NAME THAT WILL BE PLACED 
WITHIN THE IMAGE: 
HELLO 


PLACE THE DISKETTE TO BE MASTERED IN THE 
DISK DRIVE. 

PRESS RETURN WHEN READY. 
NOTE: IF YOU WANT A DIFFERENT FILE NAME, 
PRESS ESC . 





Step7: Remove your System Master from the drive and 
replace it with the slave diskette being converted to a 
master. Press the return key to begin the conversion. 
The following message will be displayed when the con- 
version has been completed: 






THE DISKETTE HAS BEEN UPDATED, YOU MAY 
REMOVE IT AT THIS TIME. 

IF YOU WISH TO “MASTER” ANOTHER DISK- 
ETTE, PRESS [RETURN] 
OTHERWISE PRESS ESC TO EXIT “MASTER” 







Step8: After you have finished using MASTER CREATE, reboot 
DOS before entering any further commands. 


The greetings program filename (specified in Step 5) is not 
actually placed in the diskette’s catalog. This prompt merely 
identifies the program that DOS should run when the diskette is 
booted. 


The newly created master diskette must contain a program with 
the filename specified in Step 5. If this is not the case, the 
following message will be displayed when you boot the diskette: 
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FILE NOT FOUND 


If you are changing the name of your greetings program, be sure 
to rename the program’s filename as described in Step 3. 


LOAD 


LOAD is used in DOS to load a program file from diskette into 
memory. 


Configuration 
LOAD filename [Sx, Vx, Dx] 


The following example would load the program file named 
PROGA from diskette into memory: 


LOAD PROGA 


If the specified filename cannot be located in the diskette 
directory, the following message will be displayed: 


FILE NOT FOUND 


If the file is located on the directory, DOS will check to be sure 
that the file is a program file. If the specified file is not a program 
file, the following message will be displayed: 


FILE TYPE MISMATCH 


If the specified file is located in the directory and it is a program 
file, the current program in RAM will be erased and the specified 
program file will be copied from the diskette file into RAM. That 
program can then be edited, renamed, listed, or run. 


SAVE 


The SAVE command is used in DOS to save a program from RAM 
onto diskette. 
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Configuration 
SAVE filename [Sx, Vx, Dx] 


When SAVE is executed, the specified drive will begin spinning 
and the in use lamp will light. This indicates that the program in 
RAM is being saved on diskette. When the drive stops spinning 
and the in-use light goes off, the prompt will reappear. The 
program will have been saved on diskette. 


If a filename is specified with SAVE that is identical to a filename 
already on diskette, the file being saved will replace the file on 
diskette. The original file will be erased. 


DELETE 


The DELETE command can be used to remove a file from a 
diskette. 


Configuration 
DELETE filename |, Sx, Vx, Dx] 
RENAME 


The RENAME command can be used to change the name of a 
diskette file. 


Configuration 
RENAME oldfilename, newfilename 


The file specified by oldname will be renamed as specified in 
newname. If newfilename specifies a filename already on 
diskette, DOS will still change the filename as indicated by 
RENAME. As a result, two files could be located on the same 
diskette with the same filename. To prevent confusion, avoid 
using the same filename for files located on the same diskette. 


If a file is locked, it cannot be renamed. Exercise caution when 
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renaming the greetings program. If the greetings program Is 
renamed, a new program should be saved on the diskette with 
the same filename as the original greetings program as DOS will 
continue to search for the greetings program under its original 
filename. 


LOCK 


Locking is a feature which prevents a file from being inadvertently 
deleted or overwritten. 


Configuration 
LOCK filename [, Sx, Vx, Dx] 


Locked files are indicated on the catalog listing with an asterisk. 
Any attempt to DELETE or RENAME a file will result in the 
following error message: 


FILE LOCKED 


Also, if an attempt is made to SAVE a file with a filename identical 
to that of alocked file, the following message will appear (if both 
files are in the same language). 


FILE LOCKED 
Ifan attempt is made to SAVE a file using the name of a filename 
of a locked file in a different language, the following message 
will appear: 
FILE TYPE MISMATCH 
VERIFY 
Sometimes, information may not be recorded correctly on the 


diskette. The VERIFY command can be used to confirm that a file 
was correctly copied. 
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Configuration 
VERIFY filename [, Sx, Vx, Dx] 


VERIFY uses the checksum value for each sector to determine 
whether or not that sector was copied correctly. The checksum 
value is calculated using the numeric value of each character in 
the sector, and is stored in the sector. 


VERIFY recomputes the checksum for each sector in the file and 
then compares these computed checksums with those stored in 
the sector. If there are any discrepancies, the following error 
message will appear: 


I/O ERROR 


If the computed and stored check sums agree, the BASIC prompt 
will be displayed. 


MON & NOMON 
MON is an abbreviation for MONITOR. The MON command is 
used to display information related to disk input and output. The 
NOMON command will turn the display off again. 
MON is useful when debugging a program. Generally, data 
transferred between the screen and disk drives is not displayed. 
MON allows this data to be displayed, which can be helpful 
during the debugging process. 
Configuration 
MON [C] [,1] [,0] 
NOMON [C] [1] [,0} 


C indicates that commands to the disk are to be monitored. (ex. 
OPEN, READ, WRITE, etc). 
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| indicates that input from the disk is to be monitored (ex. whena 
file is being read). 


O indicates that output to the disk is to be monitored (ex. when a 
file is to be written to). 


C,l, and O can be specified in any order and must be delimited 
with commas. At least one of these three parameters must be 
included with either MON or NOMON for the command to 
have aneffect. AMON remains in effect until eithera NOMON, 
INT, FP, or DOS reboot are undertaken. 


The default is NOMON C, I, O. This command indicates that no 
monitoring ts to occur. 


The different combinations of C, |, and O with MON are 
summarized in Table 5-2. 


Table 5-2. MON Command Summary 


MON Command Input and/or Output Monitored 


MON C, 1, O Disk input. Disk output. Commands to disk. 
MON C,! Disk input. Commands to disk. 


MON C, O Disk output. Commands to disk. 


MON I, O Disk input. Disk output. 


MON O Disk output. 
MON | Disk input. 


MON C Commands to disk. 
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MAXFILES 


MAXFILES allows the users to specify the number of files which 
can be open at any one time. A maximum of 16 files can be open 
at any one time. 


Configuration 
MAXFILES x 
x is an integer from 1 to 16. The default value for x is 3. 


Each file specified by MAXFILES has 595 bytes of memory 
reserved as a buffer. One 256-byte section of the buffer is used 
for reading and a second 256-byte is used for writing. The 
remaining 83 bytes are used for housekeeping information. 


One file buffer is required for the execution of each of the 
following DOS commands: 


APPEND EXEC OPEN 
BLOAD FP POSITION 
BRUN INIT READ 
BSAVE INT RENAME 
CATALOG LOAD RUN 
CHAIN LOCK SAVE 
CLOSE MON VERIFY 
DELETE NOMON WRITE 


If the number of open disk files is at the limit set by MAXFILES 
and one of the aforementioned DOS commands is executed, the 
following error message will appear: 


NO BUFFERS AVAILABLE 
MAXFILES should be executed prior to loading a program as its 


execution in the immediate mode causes the erasure of Integer 
BASIC programs as well as difficulties with strings in Applesoft. 
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If MAXFILES is executed within a program, memory pointers will 
be altered. This can cause problems with GOSUB, GOTO, and 
other instructions. If you need to execute a MAXFILES command 
within an Integer BASIC program, do so using an EXEC file 
(discussed later). 


If you need to execute a MAXFILES command in an Applesoft 
BASIC program, the command should be the first statement in 
the program and should be preceded with a Control-D character 
as illustrated below: 


100 PRINT CHR$(4); “MAXFILES 6” 
EXEC 
The EXEC command allows for the execution of an EXEC file. 
Configuration 
EXEC filename, [ Rx, Sx, Vx, Dx | 


R indicates the relative field number within the EXEC file where 
execution is to begin. RO is the default value which causes 
execution to commence at the beginning of the EXEC file. If R1 
was specified, execution would begin with the file’s second 
record. 


When the EXEC command is executed, the indicated EXEC file is 
first opened. Then, the line specified by the R parameter is read 
and executed as if it had been entered via the keyboard in the 
immediate mode. 


If the line ts a valid program line, it will be stored in memory--just 
as if it had been entered in the immediate mode. If the line is a 
command such as LIST, CATALOG, SAVE, or RUN, it will be 
executed. 
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A sample EXEC file is listed below: 


100 X=0 

200 FORX=1TO3 
300 PRINT X 

400 NEXT 

500 END 

RUN 

NEW 

CATALOG 


Once this EXEC file has been created (as explained in the next 
section) with the filename SAMPLE, it can be executed by issuing 
the following: 


EXEC SAMPLE 


When this EXEC command is executed, the following will occur: 


@ Asimple program will be entered into memory, and 


executed. 
@ The diskette’s directory will be listed by CATALOG. 


Creating an EXEC File 


First of all, a program must be written to create an EXEC file. An 
example of such a program is given below: 


10 REM CREATE EXEC 
20 D$ = CHR$(4):REM CTRL-D 
30 PRINT D$; “OPEN SAMPLE” 
40 PRINT D$; “WRITE SAMPLE” 
45 PRINT “FP” 
60 PRINT “100 X = 0” 
70 PRINT “200 FOR X =1TO 3” 
80 PRINT “300 PRINT X” 
90 PRINT “400 NEXT” 

100 PRINT “500 END” 

110 PRINT “RUN” 

120 PRINT “NEW” 

130 PRINT “CATALOG” 

140 PRINT D$; “CLOSE SAMPLE” 
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This program (named CREATE EXEC) will create an EXEC file 
named SAMPLE. Note on line 130 that the DOS command 
CATALOG need not be preceded by CTRL-D. This is the case 
with other DOS commands as well. 


Once CREATE EXEC has been saved on diskette, the following 
command: 


RUN CREATE EXEC 


will result in the creation of an EXEC file named SAMPLE. This file 
can then be executed with the following command: 


EXEC SAMPLE 
BSAVE 
DOS allows the usage of binary files as well as BASIC program 
files. Binary files are denoted with the letter B in catalog listings. 
BSAVE is used to save a binary file on disk. 

Configuration 

BSAVE filename, Axxx, Lxx, [ Sx, Vx, Dx ] 

A indicates the beginning address in memory of the data to be 
stored on diskette. If A is specified in hexadecimal notation, it 
should be preceded with the dollar sign ($). The address 
specified with A (xxx) should correspond to an actual memory 


address in the Ile. 


L indicates the length in bytes of the portion to be saved. The 
maximum number of bytes that can be saved is 32767. 


BLOAD 


BLOAD loads the contents of a binary file back into memory. 
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Configuration 
BLOAD filename [ , Axxx ] , Lxxx, [ Sx, Vx, Dx ] 


The address parameter (A) is optional in BLOAD. If A is not 
specified, the file will be loaded at the address indicated when 
the file was saved. 


BRUN 


BRUN performs a BLOAD, after which it performs a machine 
language JMP instruction to the address indicated by A. This will 
begin execution of the machine language program. 


Configuration 
BRUN filename [ , Axxx ], Lxxx, [ Sx, Vx, Dx ] 
Using DOS Commands in Programs 


In certain situations, you may wish to use DOS commands within 
BASIC programs. A DOS command can be included within a 
BASIC program by placing the command within a PRINT 
statement and prefixing the command with the Control-D 
character (ASCII Code 4). 


An example of the usage of aDOS command within an Applesoft 
program is given below: 


10 D$ = CHR$ (4) 
20 PRINT D$; “CATALOG” 


The preceding program will generate a catalog listing. 


Note that we defined D$ as Ctrl-D using the CHR$ function. 
Since actually entering Ctrl-D via the keyboard does not 
generate a printing character, this is the preferred method for 
including Ctrl-D in a BASIC statement. 
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SEQUENTIAL & RANDOM FILE ACCESS 


Diskettes can be used to store information other than a program. 
For example, a diskette file can be used to stor names and 
addresses ona mailing list, the result of aformula, a letter, or any 
other form of data. Sucha file is known asa text file (or data file). 
Text files are denoted in the catalog listing with the letter T. 


Text files are created, read from, or written to using the following 
DOS commands in an Applesoft or Integer BASIC program. 


OPEN APPEND 
CLOSE POSITION 
READ EXEC 
WRITE 


COPEN, READ, WRITE, APPEND, and POSITION can only be used 
in the program mode. If an attempt is made to use these 
commands in the immediate mode, the following error message 
will appear: 

NOT DIRECT COMMAND 


CLOSE and EXEC may be used in the immediate mode. 


Two types of text files are used, sequential text files and random 
text files. 


Each record of a sequential disk file is assigned exactly as much 
disk space as it requires. There are no blank spaces between 
records in a sequential file. 


In random data files, a constant space is assigned to every record 
in the file. If the record does not occupy the entire space 
assigned to it, the remaining space is left blank. 


The concepts of sequential and random files are pictured in 
[lustration 5-15. Notice that the length of each record in the 
random file is constant at 100 bytes. 


The record length of a sequential file is variable. The record 
length is the sum of the total space used by all the fields in each 
individual record. 


Cassette and Disk Storage with the Apple Ile 213 


Illustration 5-15. Random and Sequential Data Files 


Random File 


SECTOR 1 SECTOR 2 SECTOR 3 


Pi} Tei} Cd 


f \ / 


Record1 Record 2 Record 3 
200 Bytes 200 Bytes 200 Bytes 


Sequential Files 
SECTOR 1 SECTOR 2 SECTOR 3 
tf \ Ff £  % / 


Record 1 Record 2 Record3 Record 4 
200 Bytes 80 Bytes 190 Bytes 200 Bytes 


*Example assumes 256 bytes per sector. 
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Another difference between random and sequential files is the 
way in which each file is accessed. Direct Access of any recordin 
a random file is possible regardless of that record’s location 
within the file. 


By direct access, we mean that any record in the file may be 
retrieved regardless of its position, without having to search 
through the entire file to find it. 


Records in a sequential file can only be retrieved by sequential 
access. In sequential access, the record search begins with the 
first record in the file and must continue until the desired record 
is found. 


Opening Sequential Files 


A diskette file must be opened before it cam be accessed by a 
program. When a file is opened, DOS will check to see if the 
specified file is on disk, and if so, where it is located. OPEN also 
reserves a 595-byte buffer for input and output to the file. 


Configuration 
OPEN filename [ , Sx, Vx, Dx | 


if the specified filename is not present on the diskette, DOS will 
create an entry for that filename in the diskette’s directory. 


OPEN must be specified within quotes in a PRINT statement. 
OPEN must be preceded with Ctrl-D. In the following statements, 
a filename TEXTA is created on the default drive: 


100 D$ = CHR$(4) 

200 PRINT D$; “OPEN TEXTA” 
*300 PRINT D$; “CLOSE” 

400 END 


Writing to Sequential Files 


Information is sent to the diskette via the PRINT statement just as 
data is sent to the display or printer. However, before data can be 





* We discuss the CLOSE command on page 218. 
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sent to a diskette file with PRINT, the DOS WRITE command 
must be executed. WRITE notifies DOS that the PRINT statement 
is being used to send data to a diskette file rather than to the 
display. 


Configuration 
WRITE filename 


After the WRITE command has been executed, subsequent 
PRINT statement output will be sent to the specified diskette file. 


If an error is encountered, the error message will be sent to the 
diskette file. However, once an error message has been sent to 
the diskette file, the WRITE command will be cancelled. 


As shown in the following example, WRITE must be issued with a 
PRINT statement and preceded with Ctrl-D. 


250 PRINT D$; “WRITE TEXTA” 
260 PRINT “THIS DATA IS BEING SENT TO THE DISKETTE” 


When data is printed to a file, DOS will update an internal file 
pointer. This pointer denotes the position on the diskette 
surface where the next data items will be stored. The file pointer 
for a sequential data file can only be moved forward. The OPEN 
statement moves the file pointer to the beginning of the file. 


When you are writing to a sequential data file with existing data, 
problems can occur unless the file is first erased. This is due to 
the fact that although PRINT statements will overwrite the 
existing file contents, the previous data may extend beyond the 
end of the new data. 


This potential problem can be avoided by using the DELETE 
command prior to the OPEN command as shown in the following 
example: 
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100 D$ = CHR$(4) 

110 PRINT D$; “OPEN TEXTA” 

115 PRINT D$; “CLOSE” 

120 PRINT D$; “DELETE TEXTA” 

130 PRINT D$; “OPEN TEXTA” 

140 PRINT D$; “WRITE TEXTA"” 

150 PRINT “THIS IS THE NEW DATA” 
160 PRINT D$; “CLOSE” 

170 END 


The DELETE command in line 120 will erase the previous contents 
of TEXTA. Notice the OPEN command in line 110. This command 
is issued to prevent a possible error in line 120. If the DELETE 
command was issued in line 120, and TEXTA was not present on 
the diskette, the following error message would be displayed: 


FILE NOT FOUND 


The OPEN command in line 110 will create TEXTA in case it did 
not already exist on the diskette. 


The WRITE command must be cancelled should the user wish to 
resume sending output to the screen or printer rather than to the 
disk drive. Any DOS command will cancel WRITE. The safest 
method of cancelling WRITE is to issue the null command. The 
null command consists of the Ctrl-D character. The following 
program line would cancel WRITE: 


165 PRINT D§$ 
assuming D$ had been assigned the ASCII code for Ctrl-D. 
Reading Sequential Files 
DOS allows the user to read data from the text file as well as to 
write data to it. The READ command specifies a disk file as the 


source for data input via the INPUT and GET (Applesoft only) 
statements. 


Configuration 


READ filename 
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The READ statement must be issued in a PRINT statement and 
must be preceded with the Ctrl-D character. Once a READ 
command has been issued, INPUT statements will accept data 
from the file specified in filename until a subsequent DOS 
command or an error cancels READ. 


The following illustrates the use of READ: 


100 D$ = CHR$(4) 

110 PRINT D$; “OPEN TEXTA” 
120 PRINT D$; “READ TEXTA” 
130 INPUT Xx$ 

140 PRINT X$ 

150 PRINT D$; “CLOSE TEXTA” 
160 END 

] RUN 

THIS IS THE NEW DATA 


In Applesoft, the GET statement can also be used to read data 
from a disk file. Unlike INPUT, GET returns just one character. 
Therefore, if our text file included the following phrase: 


THIS IS THE NEW DATA 


after an OPEN and READ were executed, the first GET statement 
would return the letter T, the second GET statement would 
return the letter H, etc. 


The following program illustrates the use of GET to read data 
from a text file: 


100 D$ = CHR$ (4) 

110 PRINT D$; “OPEN TEXTA” 
120 PRINT D$; “READ TEXTA” 
130 X$=“ ” 

140 GET Y$ 

150 IF Y$ = CHR$ (13) THEN 180 
160 X$ = X$ + Y$ 

170 GOTO 140 
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180 REM RETURN CHARACTER ENCOUNTERED 
185 PRINT X$ 

190 PRINT D$; “CLOSE” 

200 END 


JRUN 
THIS IS THE NEW DATA 


Closing a Sequential File 


Once a file has been opened, it should be closed. Failing to close 
a file can result in the loss of data in the file left open as well as 
possible loss of data on another diskette. 


Configuration 
CLOSE [ filename | 


When CLOSE is used without a filename parameter, all open files 
on all diskettes will be closed. If filename is specified with 
CLOSE, the specified file will be closed. 


APPEND 


The DOS APPEND command allows the user to place the file 
pointer for a sequential file at the end of the last data item. Since 
the file pointer is reset after a file has been closed and re- 
opened, APPEND is a useful command--especially in situations 
where the user wishes to add text to the end of a sequential file. 


Configuration 
APPEND filename [ , Sx, Vx, Dx | 
The APPEND command will place the file pointer to the first 
character position beyond the end of the file. If data is written to 


the file after an APPEND has been executed, that data will be 
written immediately after existing file data. If an attempt is made 
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to read data from the file after an APPEND has been executed, 
the following error message will be displayed: 


END OF DATA 


APPEND performs an OPEN on the specified file if that file 
already exists. If the specified file does not exist, the following 
error message will be displayed: 


FILE NOT FOUND 
In other words, unlike OPEN, APPEND will not create a file. 


POSITION 


POSITION can be used to move the file pointer to any given field 
in the sequential file. 


Configuration 
POSITION filename [ , Rxx] 


filename specifies the file whose file pointer is to be moved. R 
indicates the relative field position, and xx indicates the number 
of fields to be moved forward. (POSITION can only be used to 
move the file pointer forward). 


If xx =0, then any READ or WRITE operation will be undertaken 
in the current field. If xx = 1, the current field will be skipped 
over, and any READ or WRITE operations will be undertaken in 
the next field. If xx = 2, the current field and the following field 
will be skipped, before any READ or WRITE operation will occur. 


A file must have been OPEN’ed before POSITION can be 
executed. Since OPEN sets the file pointer to the beginning of 
the file, if POSITION is executed immediately after OPEN, the 
Rxx parameter will select the absolute field position within the 
file. In other words, the relative file position (selected by R) will 
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correspond to the absolute file position. This only occurs when 
the file pointer is positioned at the beginning of the file. 


POSITION like all DOS commands will cancel a READ or WRITE 
command. For this reason, execute POSITION prior to the 
execution of READ or WRITE. 


POSITION functions by examining the file byte by byte. When 
POSITION encounters the ASCII code for return, it assumes that 
the current field’s ending point has been reached. If POSITION 
encounters an unused byte, it will assume that the field requested 
does not exist. The following error message will be displayed: 


END OF DATA 


The following program illustrates the use of POSITION: 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 


D$ = CHR$ (4) 

A$ = “JOHN”: B$ = “BILL”: C$ = “JACK” 
PRINT D$; “OPEN TESTB”’ 

PRINT D$; “WRITE TESTB”’ 

PRINT A$:PRINT B$: PRINT C$ 
PRINT D$; “CLOSE TESTB” 

PRINT D$; “OPEN TESTB”’ 

PRINT D$; “POSITION TESTB, R2”’ 
PRINT D$; “READ TESTB” 

INPUT Z$ 

PRINT Z$ 

PRINT D$; “CLOSE TESTB”’ 

END 


JRUN [Ret] 
JACK 
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Storing Data in Disk Files 


Caution must be exercised when storing numeric values in disk 
files. For example, if the following program was executed in 
Applesoft BASIC: 


050 A=0:B=0 
100 D$ = CHR$(4) 

110 PRINT D$; “OPEN TEST C” 

120 PRINT D$; “WRITE TEST C” 
130 PRINT 1,2,3,CR,4,5 

140 PRINT D$; “CLOSE TEST C” 
150 PRINT D$; “OPEN TEST C” 

160 PRINT D$; “READ TEST C” 

170 INPUT A 

180 PRINT A 

190 INPUT B 

200 PRINT B 

202 INPUT C 

204 PRINT C 

210 PRINT D$; “CLOSE TEST C” 
220 END 

RUN 


The following display would appear: 


123 


Notice from lines 170 and 180 that the first three of the PRINT 
statement parameters (in line 130) were concatenated to forma 
single number (123). The next output line consisted of the fourth 
PRINT statement (4). The final output line consisted of the fifth 
PRINT statement parameter. 
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This situation arises because of the format in which information 
is stored on disk files. When a PRINT statement is directed to the 
display, if commas are used to delimit parameters, each 
parameter is displayed at the next tab position on the screen. 


However, when PRINT statement output is sent to a disk file, the 
commas are ignored. Therefore, all parameters are concatenated 
until the carriage return character (ASCII 13) is encountered. In 
DOS, the carriage return character is the only character which 
can be used to separate values. 


In Integer BASIC, a carriage return character is output after the 
fifth tab stop. In Applesoft BASIC, a carriage return character is 
output after the third tab stop. In our Applesoft program 
example, a carriage return was inserted as indicated. This caused 
the PRINT statement output in line 130 to be concatenated as 
two separate numeric values. 


Whenever you wish to output a number of items via the PRINT 
statement to different fields in the disk file, either separate 
PRINT statements should be used or each PRINT statement 
parameter should be delimited with the return code character. 
This is illustrated in the following program lines: 


130 PRINT 71:PRINT 2:PRINT 3:PRINT 4:PRINT 5 


OF 


100 D$ = CHR$ (4):E$ = CHR$ (13):REM CTRL-D 
IS ASCII 4; RETURN IS ASCII 13 


130 PRINT 1; E$; 2; E$; 3; E$; 4; E$; 5 


If you substitute these lines in the example, the following output 
will appear: 
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Opening and Closing A Random Access File 


The following configuration is used to opena random access file: 


Configuration 
OPEN filename, Lxx [ , Sx, Vx, Dx ] 


L is known as the length parameter. L is a required parameter 
which denotes the length of each random access record. L can 
range from 1 to 32767. 


The CLOSE statement is used to close a random access file just as 
it is used to close a sequential file. 


Reading and Writing to Random Files 


The following configuration is used to read from or write to a 
random access file. 


Configuration 
READ filename, Rxx [ , Sx, Vx, Dx ] 
WRITE filename, Rxx [ , Sx, Vx, Dx ] 


R is known as the record parameter. R moves the file pointer to 
the beginning of the specified record. 


The following program illustrates reading from and writing to a 
random file. 


10 D$ = CHR$ (4) 
20 PRINT D$; “OPEN RANDOM, L20” 
30 PRINT D$: “WRITE RANDOM,R2” 
40 PRINT “RECORD NUMBER TWO” 
50 PRINT D$; “WRITE RANDOM, R3” 
60 PRINT “THIS IS RECORD 3” 
70 PRINT D$; ‘WRITE RANDOM, R1” 
80 PRINT “RECORD 1” 
90 PRINT D$; “WRITE RANDOM, R4” 
100 PRINT “RECORD 4” 
110 PRINT D$; “CLOSE RANDOM” 
120 GOTO 180 
130 PRINT D$; ““OPEN RANDOM, L20” 
140 PRINT D$; “READ RANDOM, R”; R 


224 Apple lie Users Handbook 


150 INPUT X$ 

160 PRINT D$; “CLOSE RANDOM” 

170 RETURN 

180 INPUT “ENTER RECORD NUMBER ”; R 
190 GOSUB 130 

200 PRINT X$ 

210 GOTO 180 


Byte Parameter 


The B or byte parameter can be used with the READ, WRITE, and 
POSITION statements to move the file pointer to a specified byte 
within asequential file or a specified byte within a specified field 
in a random file. 


For example, the following command: 
WRITE TEXTA, B20 


would set the file pointer to the twenty-first byte in the 
sequential file named TEXTA. The first byte is byte 0. Any 
characters output to the disk file by subsequent PRINT statements 
will replace existing characters in TEXTA beginning with byte 21. 


If R is specified, the B parameter sets the file pointer to the 
specified byte in the record indicated by R. In the following 
example: 


READ TEXTA, R20, B4 


the read operation will begin at the fifth byte in the twenty-first 
record. 


When using the byte parameter, the user must know exactly 
what data has been stored in the file. Remember that spaces, 
commas, return codes, and all characters are stored in byte 
positions within a field. 


CHAPTER 6. 
APPLE Ile GRAPHICS 





The Apple Ile has three different display modes — one text 
mode and two graphics modes. These formats may be combined 
into five different display formats. Both of the graphics modes 
are color capable. These two modes will be discussed in this 
chapter. 


The Apple Ile can generate some of the finest color graphics 
available on a medium priced computer system ($1000-$2000). 
This is quite amazing, in light of the fact that the Apple was one 
of the first color capable home computers. 


LOW RESOLUTION GRAPHICS 


The low resolution graphics mode is used in two of the pre- 
viously mentioned display formats. A graphics-only display is 
available that has a resolution of 40 x 48 pixels.* Also a graphics 
plus text display is available that has a resolution of 40 x 40 pixels. 
In this mode, four lines of text are located beneath the graphics 
display. 


Commands 


The GR command is used to call the low resolution graphics 
mode. This command configures the computer hardware to 
display the graphics plus text format. This command also clears 
the display memory so that the screen will initially be black. The 
GR command can be used in a program or executed directly 
from the keyboard, as can all graphics commands. 


*A pixel can be defined as a single screen coordinate. 
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GR set low resolution 
graphics & text 


Besides clearing the screen, the GR command also sets the low 
resolution ‘next color’ register to 0. This register stores the 
numeric value of the next color to be displayed. 


The four lines of text that appear beneath the graphics mode can 
be replaced with 8 more rows of the graphics mode. This extends 
the display resolution to 48 x 40 pixels. This switch can be 
accomplished by reading or writing to memory location 49234. 
The easiest means of accomplishing this is by poking the 
location. 


POKE 49234,0 full screen graphics 


To replace the four lines of text without erasing any graphics 
information on the screen, read or write to memory location 
49235. Again, this can be accomplished by poking the location. 


POKE 49235,0 graphics & text 
(no erase) 


Before any graphics information can be plotted on the screen, a 
color must be selected. This is accomplished through use of the 
COLOR command. The correct syntax of this command is as 
follows: 


COLOR = x 


x represents anumber between 0 and 255. The color correspond- 
ing to x modulo 16 is selected. For example, if x =2 or 18 then 
color number two is selected. The colors and their associated 
numbers are listed in Table 6-1. 
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Table 6-1 Color Numbers. 


black brown 


magenta orange 
dark blue grey 
purple pink 


dark green green 
grey yellow 
medium blue aqua 
light blue white 





After a COLOR has been selected, information can be plotted 
to the screen. This is accomplished by using the PLOT command. 
The correct syntax of this command is as follows: 


PLOT x,y 


x is the column number. y is the row number. The column 
numbers extend from 0 (left) to 39 (right). The row numbers 
extend from 0 (top) to 47 (bottom). For example the following 
program plots two orange squares in the upper righthand corner 
of the screen. 


10 GR ——r set low resolution mode 
20 COLOR =9 ——» © select ORANGE =9 

30 PLOT 39,1 ——~~ _ plot first square 

40 PLOT 38,0) ———» plot second square 


If a graphics & text format is being displayed, plotting to a row 
number between 40 and 47 will cause a character to be displayed 
at that location. 


VLIN and HLIN can be used to plot consecutive pixels. VLIN and 
HLIN are abbreviations for Vertical LINe and Horizontal LiNe 
respectively. The correct syntax for the VLIN command is as 
follows: 


VLIN yi,y2 AT x 
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y, and y> represent the range of row numbers. x represents the 
column number. The following VLIN command will plot every 
pixel in column 30 from row 4 to row 24, 


VLIN 4, 24 AT 30 
The correct syntax for an HLIN command is as follows: 
HLIN x,,x5 AT y 


x, and x, represent the range of column numbers. y represents 
the row number. The following HLIN command will plot every 
pixel in row 14 from column 2 to column 37. 


HLIN 2, 37 AT 14 


After information has been output to the screen, it may become 
necessary to determine which color is displayed at a certain 
screen position. The function SCRN takes as its arguments the 
row and column numbers, and returns the color number. The 
correct syntax of the SCRN command is as follows: 


X=SCRN (x,y) 


x represents the column number. y represents the row number. 
Upon execution of the preceding command, X will be assigned 
the value of the color at screen location column =x, row =y. 


Uses of Low Resolution Graphics 


The use of low resolution graphics is usually limited to drawings 
and simple charts. This is because low resolution graphics is not 
well-supported in BASIC. 


Charts 


Simple bar charts are easily implemented by using low resolution 
graphics. The text window may be used for documentation or 
labels. For example, the following program displays a monthly 
sales chart. 
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10 DIM A(12) 

20 FORI=1T0O12 

30 A(l) = 30 * RND(1) 

40 NEXTI 

50 GR:HOME | 

60 PRINT”MONTH: JFMAMJJASOND” 
70 FORI=1TO12 

80 COLOR =I 

90 VLIN A(l),39 AT5+2*1 

100 NEXT 


Lines 10-40 initialize the array A with random values. Line 50 | 
clears the entire screen. Line 60 prints the headings on the 
column. Lines 70-100 plot the bar charts. 


Writing a Game Program 


In this section, the game, “BARACADE?” will be designed. The 
object of the game is to avoid the baracades as well as your own 
trail. The game will be written in BASIC so that it may be easily 
modified. 


If the reader does not wish to follow the step-by-step designing 
of BARACADE, he may page through the chapter. All program 
lines may easily be distinguished from the rest of the text. To play 
BARACADE, merely enter every line belonging to the program. 


The first step in designing ‘“BARACADE?” is to program the com- 
puter to draw a trail. The following statements accomplish this. 


10 GR: HOME 

140 Y=20:X=20:A=65 
150 COLOR =4 

155 GET A$ 

160 IF PEEK(-16384) >127 THEN GET A$: A=ASC(A$) 
170 IF A=8 THEN X = X-1 
180 IF A =21 THEN X = X+1 
190 IF A=65 THEN Y =Y-1 
200 IF A=90 THEN Y = Y+1 
220 PLOT X,Y 

250 GOTO 160 
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Line 10 clears the screen and enables low resolution graphics. 
Line 140 sets the initial position at screen location (20,20). This ts 
the center of the screen. The A =65 statement that also appears in 
line 140 selects “up” as the initial direction of movement. 

(A) 

65 


90 
(Z) 


These values represent the ASCII coded values for the controller 
keys: A, Z, — and +. 


Lines 160-250 set up a loop that monitors the keyboard and acts 
accordingly. Line 160 checks for a keypress and sets the direction 
variable, A. The expression PEEK (-16384) > 127 ts true whenever 
a key has been pressed. Lines 170-200 recalculate the postion 
variables. Executing the program is the best way to understand 
how it operates. By the way, the program will not operate cor- 
rectly if an 80-column card is presently active. See Chapter 8 for 
instructions about how to deactivate the card. 


Recall from our description of BARACADE, that one of the rules 
was that the player was not allowed to collide with his trail. The 
SCRN function will be used to check for collision. If the follow- 
ing line is added to the program, collisions wili be detected. 


210 IF SCRN (X,Y) > 0 THEN 260 
The program has not yet been completed. When it is run, an 


error occurs after every collision. This is because the computer 
does not know where to jump when there is a collision. Let’s tell 
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it, by adding the following lines to the program. 


260 PRINT “COLLISION” 
270 FORJ=1TO12 

280 PRINT CHR$(7);:NEXT J 
290 INPUT A$ 

300 GOTO 10 


The PRINT statement in line 280 activates the consol speaker. 
Line 290 delay’s a new game from starting until return has been 
pressed. 


A BARACADE’s score can be easily kept track of by merely incre- 
menting a variable each time a move has been completed. 


130 I=0 
230 1=!1+1 
240 HOME: PRINT | 


A final technicality remains — creation of a playing field. A 
square field with scattered barriers was chosen. 


20 COLOR =9 

30 =~VLIN 0,39 AT 0 
40 VLIN 0,39 AT 39 
50 HLIN 0,39 AT 0 
60 HLIN 0,39 AT 39 


Line 20 sets the playfield color to orange (9). Lines 30-60 draw a 
square border around the field. 


70 FORK=1TO6 
80 GOSUB 310 

90 HLINL,L+5 ATM 
100 GOSUB 310 

110 VLINL,L+5 ATM 
120 NEXT K 


The previous addition to the program draws randomly located 
barriers around the playfield. The subroutine at 310 must pro- 
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vide random values for the variables L and M, which have a range 
from 0 to 34 inclusive. 


310 L =34*RND(1) 
320 M=34*RND(1} 
330 RETURN 


The ideas in this section by no means exhaust the possibilities 
that could be added to “BARACADE.” Other upgrades might 
include: keeping track of the high score, or adding another 
player. The only two limiting factors are execution speed and 
one’s imagination. 


HIGH RESOLUTION GRAPHICS 


The Apple can also be configured to display one of two high 
resolution graphics formats. A graphics-only display is available 
that has a resolution of 280 x 192 pixels. Also, a graphics plus text 
display is available that has a resolution of 280 x 160 pixels. In this 
mode, four lines of text are located beneath the graphics display. 


Commands 


All high resolution graphics commands directly parallel their low 
resolution counterparts. Therefore, familiarity with the low 
resolution commands will be assumed throughout the remainder 
of this chapter. 


The HGR command can be used to configure the computer to 
display the graphics plus text format. The command clears the 
display memory (2000-4000 Hex), so that the screen will initially 
be black. 


HGR set high-resolution 
graphics + text 


é 


The HGR command does not clear the high resolution “next 


color”’ register. 


The four lines of text that appear beneath the graphics mode can 
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be replaced with 32 more rows of the graphics mode to increase 
the display resolution to 280 x 192 pixels. This is accomplished in 
the same manner as was a similar switch using low resolution 
graphics. 


POKE 49234,0 full screen graphics 
POKE 49235,0 graphics + text 
(no erase) 


A second high resolution command is: 
HGR2 set high resolution graphics only. 


This command clears then displays high resolution page 2. Page 2 
is located at memory addresses 4000-6000 Hex. Use of this com- 
mand has one advantage over HGR — more memory space is 
available for program use. HGR2 has the disadvantage that it 
does not easily support a graphics plus text display. As a side note 
— if the command GR is issued while HGR2 is in effect, low 
resolution page 2 will be displayed. BASIC does not support this 
display mode. Enter TEXT to recover from this error. 


An HCOLOR command must be used before any graphics may 
be output to the high resolution display. This command selects 
the color that will be displayed next. The correct syntax of this 
command is as follows: 


HCOLOR = x 
x represents a number between 0 and 7. Each number corres- 
ponds to a specific color. This information is contained in Table 
6-2. 
Table 6-2. 


Q- black 4- black 
1- green 5- orange 


2- purple 6- blue 
3- white 7- white 
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High resolution graphics has a single command that can be used 
to output data to the screen. HPLOT is more flexible than PLOT, 
HLIN, and VLIN combined. In HPLOT’s simplest form, it func- 
tions as low resolution’s PLOT command. 


HPLOT x,y 


x is the column number. y is the row number. The column 
numbers extended from 0 to 279, The row numbers extend from 
0 to 191. The computer stores the column number and row 
number of the last plotted coordinate. 


The next form of the command is as follows: 
HPLOT TO x,y 


The computer executes this command by drawing astraight line 
from the last plotted point to the point with coordinates (x,y). 
The line color will be the last color selected by the HCOLOR 
command. These two versions of the HPLOT command may be 
combined as follows: 


HPLOT x,,y; TO xo,y> 


This command will cause a line to be drawn from screen coordi- 
nate (x,,y,) to screen coordinate (x»,ys). x. and y, will be stored 
as the last plotted coordinate. 


The reserved word TO may appear more than once ina single 
HPLOT command. 


HPLOT 1,1 TO 20,100 TO 200,30 


The previous command will initially cause a line to be drawn 
from 1,1) to (20,100). A second line will then be drawn from 
(20,10J) to (200,30). Finally, the value 200 will be stored as the 
column number, and the value 30 will be stored as the row 
iumber. 
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Shape Table 


BASIC has five commands that allow the manipulation of shapes. 
These commands are: 


SCALE 
ROT 
DRAW 
XDRAW 
SHLOAD. 


Before these commands may be used, a shape table must be 
defined. The first step in the definition of the table is to draw the 
shape on paper. Graph paper works best. 





+ 


+ + 
Pe 
Bee ase 
= ie 
ae | 
Os Pa es 
Be eee tt 
















































Suppose a square is to be defined. Draw the square on graph 
paper. Now, starting at the center of the figure, connect all 
points in the shape with a continuous line. Use only 90° angles 
on the turns. Next, add arrows on the lines to indicate the 
direction that was used to connect the points. Numbering is a 
good practice here. 
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The arrows are called plotting vectors. These vectors must be 
translated into their binary codes. The following table supplies 
these binary codes. 


Draw vectors 100 I up 
101 — right 
110 1 = down 
111 — left 

Move vectors 000 I up 
001 — right 
010 $ = down 
011 — left 


An example of a move vector could be vector #2 from the square. 
A move vector plots nothing onto the screen. It merely moves 
the starting position of the next vector. An example of a draw 
vector could be vector #11. A draw vector draws a line. 


The easiest way to accumulate the necessary binary information 
is by using a table as shown on page 237. 
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Table 6-3. Vectors 


[vector# | direction [ binary code 


1 
2 
3 
4 
5 
6 
7 
8 





The Apple Ile stores information in words of eight bit binary 
numbers. Because the binary direction codes are only three bits 
long, it would be wasteful to put only one plotting vector ina 
memory location. Usually two and sometimes three plotting 
vectors can be stored in a specific memory address. 


A few rules must be followed while packing the binary codes 
into memory: 


1— all bytes are read from right to left. 

2— if all remaining sections of a byte contain all zeros 
the rest of the byte will be ignored. 

3— only a move instruction may be placed in section X 
of a byte. 
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A memory byte may be divided as follows. 


< 


Z 


To pack the binary codes in Table 6-3 into memory locations, 
perform the following steps. Place the binary code for vector #1 
into section Z of a byte. 


x x 1x x x fo 1 0 


If the next vector is a move vector, place it in section X. In our 
example, the square, itis not a move vector (vector #3 = plot —). 
If the next vector is not a move vector, place two zeros In section 
X. 


© 
— 
© 
& 
— 
om) 


i 


Notice that a “move — |” vector may not be placed in section X. 
In fact, in any byte, a “move — [” vector must always have 
another command to the left of it. This is due to rule 2, as stated 
previously. 


After a byte has been filled, start filling the next byte in a similar 


manner (vector #3 into section Z of byte 2). 


byte 1 
byte 2 


oe 
>< 

>< 

~<IO 
=< ~<a 

tO 

ys cm) 
NSN) | oy 

=) Cc 
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This process should be continued until the list of vectors has 
been exhausted. 


001010] 01 01] bytet 
0oo0o11014]1 01 2 
001100/1 00 3 
0oo/10o0]/1 00 4 
0oo0o{1414f11 1 5 
oof111$111 6 
oo}]110{1 1 0 7 
001110]1 1 0 8 
0011031101 g 





The last byte should be set to zero. 


00010010 
00101101 
00100100 
00100100 
00111111 
00111111 
00110110 
00110110 
00101101 
00000000 =0 


These byte values should now be converted to hexidecimal. This 
is done by repartitioning the bytes into sections of 4 bits each. 
Use Table 6-4 to convert a four digit binary number into a single 
hexadecimal digit. 
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Table 6-4. Binary-Hex Conversion 





The series of bytes previously calculated is called a shape 
definition. 


12 2D 24 24 3F 3F 36 36 2D 00 


A little more information will be needed to complete the shape 
table. 


Shape Table Directory 


The shape table directory contains the number of shape defini- 
tions in the table. It also points to the starting location of each 
shape definition. A maximum of 255 shapes may be defined ina 
shape table. 


The first byte of the shape table contains the number of shape 
definitions in the table. The second byte is not used. Starting with 
the third byte, a table of indices is stored, which references the 
Starting addresses of the individual shape definitions. 


byte 0 —— # of shapes 

byte 1 *— Unused 

byte 2 — offset of 1st shape 
byte 3 

byte 4 -— offset of 2nd shape 
byte 5 

byte 6 


byte 7 
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The offset is the value that must be added to the starting address 
of the table to obtain the starting address of a specific shape 
definition. 


An example will be developed using the previously calculated 
shape definition of a square. The shape table will be stored at 
memory locations 1FO00—1FOD. Therefore, memory location 
1F00 must contain the number of shape definitions in the table. 
In our case, this is one. 


1F0O0 01 
The value stored in the next location is insignificant. 
1FO01 00 


The memory location 1F02 and 1F03 must contain the value of 
the offset of shape definition number one. The starting address 
of the shape definition has been chosen at 1F04. The offset from 
1F00 is, therefore, 4 bytes. 


1F04 
-1F00 


—— 


0004 
high byte = 00 low byte = 04 


This value must be stored in memory locations 1F02-1F03. Values 
must be stored low byte first. This means that the 04 is stored in 
location 1F02. 


1F02 04 low byte 
1F03 00 high byte 
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Our completed shape table appears as follows: 


directory 


shape 
definition 





This shape table maybe entered into the computer by using the 
monitor. 


*1F00: 01 00 04 00 12 2D 24 24 3F 3F 36 36 2D 00 


The starting address of the shape table must be stored at memory 
location E8. The monitor command: 


*£8:00 TF 
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accomplishes this, as would two BASIC POKE commands. 


] POKE 232,0 
] POKE 233,31 


Saving a Shape Table 


To save a shape table on cassette tape, three data values are 
required. The starting address and ending address of the shape 
table must be known. Also the difference between the two must 
be known. In our example, 


STARTING ADDRESS — 1F00 
ENDING ADDRESS 1FOD 
DIFFERENCE 0D 


The difference must be stored in the memory location 0, low 
byte first. From the monitor, enter the following: 


*0:0D 00 


Now write all necessary information to cassette tape by entering 
the following: 


* 0.1W 1F00.1FODW (no return) 


Do not press the RETURN key until the RECORD button has 
been pressed on your recorder. 


To use the tape, rewind it to the beginning of the stored shape 
table. Next, enter the following BASIC command. 


SHLOAD 


The console speaker will be activated twice upon completion of 
the command. 


A shape table can also be stored on a floppy disk. The BASIC 
BSAVE command could be used to store the table. 
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BSAVE TABLE,A$1F00,L$0E 


The shape table may be loaded back into the computer by 
executing the following. 


BLOAD TABLE 


After Binary LOADing the table into the computer from disk, 
memory location E8 must be loaded with the starting location of 
the shape table. This is automatically accomplished when 
SHLOAD is executed with a cassette tape. 


Using the Shape Table 


BASIC has four commands which can be used to display and 
manipulate previously defined shapes. 


DRAW 
XDRAW 
ROT 
SCALE 


SCALE 


The SCALE command gives the size at which a shape is to be 
displayed. The SCALE command takes the following form, 


SCALE = x 


x is a numeric arguement with a range of 0-255. This command 
should be executed before DRAWing any shape to the screen. 


lf x =10 then the Apple Ile will draw each vector in the shape 
definition to a length of 10 pixels. 
ROT 


The ROT command rotates the shape around its center. The 
syntax of this command is as follows: 


ROT =x 
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x isa numeric argument with a range of 0-63. 


0 


48 16 


37 37 


When x = 16, any shape that is drawn will be displayed with a 
rotation of 90°. The variable x may assume a value between 
0-255. The number used to calculate the rotation is x modulo 64. 


DRAW 
The syntax of the DRAW command is as follows: 
DRAW n AT x,y 


nis the number of the shape to be drawn. x,y is the coordinate on 
which the shape is to be centered. DRAW will plot the shape 
using the previously chosen rotation, scaling, and color (ROT, 
SCALE, and HCOLOR respectively). If DRAW is used without 
specifying a coordinate, the shape will be drawn at the last 
location that was plotted to. 


XDRAW 


The XDRAW command allows the erasing of a previously dis- 
played shape. XDRAW will not change any of the background 
graphics. The syntax of this command is very similar to that of the 
DRAW command. 


XDRAW n AT x,y 
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nis the index of the shape in the shape table. x,y is the position 
from which to erase the shape. 


In order to erase a previously displayed shape, the ROTation, 
SCALE, and HCOLOR variables must be the same as when the 
shape was drawn. 


PROGRAMMING WITH SHAPE TABLES 
Shape tables can be used in a variety of implementations. 
They are especially useful for movement and pattern replication. 


The following programs serve as examples of the effects of exe- 
cuting the four shape table commands. 


PROG | 
10 HGR2 
20 FORI=1TO 40 
30 SCALE =1 
40 ROT =| 


50 HCOLOR =1/6 

60 DRAW 1 AT 140,96 
70 NEXT | 

80 GOTO 20 


PROG I 


10 HGR2 

20 SCALE = 20 

30 HCOLOR = 3 

40 FOR | =0TO 63 

50 ROT =I 

60 DRAW 1 AT 140,96 
70 XDRAW 1 AT 140,96 
80 NEXT | 

90 GOTO 40 


Apple Ile Graphics 247 


PROG Ill 


10 HGR2 

20 ROT =1 

30 FOR J =0TO7 

40 HCOLOR =] 

50 FOR | =1 TO 40 
60 SCALE =I 

70 DRAW 1 AT 140,96 
80 NEXT | 

90 NEXT J 
100 GOTO 30 


CHAPTER 7. 
THE SYSTEM MONITOR 





Introduction 


The System Monitor is a set of machine language programs built 
into the Apple Ile. The System Monitor, or operating system, was 
written to control the system functions of the Apple. The system 
functions include: 


monitoring the keyboard and peripherials for inputs 
displaying output on the screen 

saving and retrieving programs from cassette 
controlling the speaker 

allowing the user access to machine language 


The operating system’s programs are used by high level lan- 
guages such as Applesoft and Integer BASIC. The Apple Disk 
Operating System also uses these machine language programs. 


Appendix | lists many of the more useful machine code pro- 
grams as well as their starting locations. These programs have 
been written as subroutines, so that other programs may access 
them. 


The remainder of this chapter will focus on the subset of pro- 
grams that allows the user direct access to machine language. 
The balance of the chapter assumes at least a rudimentary 
knowledge of 6502 machine language. 


Activating and De-activating the Monitor 
When the computer is powered-up, a disk boot is attempted, 


after which control is given to Applesoft BASIC. In order to 
activate the Monitor, type: 
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CALL -151 


This immiediate mode statement tells the Apple to jump to 
memory location FF69,,. which is the starting address of the 
monitor. The montor should now have displayed its asterisk 
prompt. 


Ina disk based system, there are two versions of the monitor. The 
newer version is stored in ROM. During the power-up sequence, 
when the computer boots DOS, the old version is loaded into 
RAM. 


The newer version has the same standard input and output 
subroutines, but a few features are different. For example, 
because the older version was written for the Apple II, it doesn’t 
support the arrow keys for cursor movement. When INT is typed 
in Applesoft to activate Integer BASIC, the old monitor is also 
activated. It remains active until either FP is typed to return to 
Applesoft or PR#3 is typed to activate the 80-column firmware. 
Part of the 80-column initialization sequence loads the newer 
monitor from ROM to RAM. After this has occurred, the new 
monitor will remain active until the computer has been shut off. 


The old monitor has one advantage over the newer version. The 
old monitor has a mini-assembler built in. The new version does 
not. This means that Integer BASIC must have control, when the 
monitor is activated to use the mini-assembler. 


To return to BASIC, type CTRL-B, the return-to-BASIC command. 
Control is given to whichever BASIC had control when you 
activated the monitor. The CTRL-B command erases all variables 
and any BASIC program stored in RAM. It is analogous to typing 
NEW tn BASIC. 


Since erasing all variables and BASIC program storage could 
prove quite unproductive, the monitor offers the option of 
returning without erasing these. The CTRL-C, command accom- 
plishes the return to BASIC without destoying the program or 
variables. The user can generate the same effect as CTRL-C by 
pressing CTRL-RESET or by entering the command line 3D0G. 
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Commanding the Monitor 


The important thing to remember when using the monitor is that 
it is very picky. In other words, monitor commands must be 
entered with the correct syntax. In this section, the monitor 
commands will first be presented in detail. There will also be a 
short lookup section at the end of the chapter. 


The monitor accepts command lines up to 255 characters in 
length. All command lines must end with a [return]. Commands 
contain three types of information: command characters, add- 
ress values and data values. Command characters are single 
alphabetic characters, control characters and punctuation marks, 
usually preceded by an address value. 


Addresses and data values are expressed in hexadecimal nota- 
tion. Addresses can consist of as many as four digits; data can 
consist of up to two. If an address or data value is entered with 
fewer than the maximum number of digits respectively, the 
monitor automatically adds leading zeros. If a value greater than 
the maximum is typed in, the monitor only recognizes the 
rightmost field of digits. For example, if 78FE4 is entered as an 
address only 8FE4 will be recognized. Likewise if 788FE is entered 
as a data value, then only FE will be recognized. 


Quite a few examples are contained in this chapter. To make for 
easier reading, the computer’s responses will be displayed in 
bold. Because of the random nature of the computer’s memory 
after power-up, some of the data values which the computer 
displays may differ from these values in our examples. 


Memory Examine 


To examine the contents of any memory location, just type the 
hexadecimal address of the location, followed by return. 


*E300 
E300-88 


“FF 
OOFF-ED 
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In the second example, the monitor supplied the leading zeros. 


After the monitor received the address, it printed that address 
followed by its contents. 


It also did one more thing which was not quite so apparent. It 
stored the memory location that was examined as the last 
opened address. Although this seems rather unnecessary now, 
this extra step will prove very convenient when other monitor 
commands are used. 


Memory Dump 


Examining one location at a time is fine, but this could be come 
quite tedious should, say, 100 consecutive locations need to be 
displayed. The monitor’s answer to this dilema is referred to asa 
memory dump. 


A memory dump is accomplished by typing a period (.), followed 
by an address. The monitor will display the contents of each of 
the bytes which follow the opened address up to the final 
address, as specified in the command line. The amount of data 
displayed depends upon the differnece between these two 
addresses. 


*E000 
E000-20 


Hex E000 is now the last opened address. 


* EOOF 
E001 -00 FO 4C B3 E2 85 33 
E008 -4C ED FD 60 8A 29 20 ~=C*+FCO 


Data is always displayed in groups of eight or less. This simplifies 
the reading of the data. For example, the contents of memory 
location E009 is easily read as ED. The monitor again stores the 
location of the last displayed location, EOOF. 


Sometimes it is difficult to know how many locations one wishes 
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to display. The user can quickly step through memory eight bytes 
at a time by merely pressing the [return] key. The monitor will 
display eight bytes in a row, but it is particular which eight it 
displays. The monitor will display an address ending with a zero 
or an eight followed by the contents of that address as well as the 
data of the next eight bytes. Therefore, the first time [return] is 
pressed, the balance of whichever line the monitor would have 
displayed will be printed. Each successive [return] produces the 
next display line. 


Monitor commands can be combined into one command line. 
For example, to display the contents of locations D300 to D31C 
Hex, type: 


*D300.D31C 

D300-AF D3 48 20 9A D3 68 20 
D308-2E DO AE 23 03 60 20 F9 
D310-D2 4C 7D DO AD 25 03 4A 
D318-20 90 D3 20 75 


Register Examine 


When the monitor is activated, the contents of the registers in 
the 6502 are saved in page-zero. The only register not saved is the 
program counter. The accumulator, X-register, Y-register, pro- 
cess status register and stack pointer are saved in memory loca- 
tions 45 through 49, respectively. Instead of typing 45.49 to dis- 
play the contents of these registers, the monitor provides the 
register examine, CTRL-E, command. After displaying the con- 
tents of these registers, the monitor stores 45, the address of the 
accumulator, as the opened address. 


*CTRL-E 
A=18 X=FE Y=FF P=BO S=F8 


Changing Memory 


We have now seen how any location in memory can be dis- 
played. If Picasso could only have looked at his canvas without 
changing it, how much of an artist would he have been? The 
same concept applies to the programmer and his canvas, the 
computer. 
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The computer cannot be made tc do useful work unless it can be 
given instructions. This is done by changing the contents of 
memory. 


To extend the metaphor a bit further, (since) the Apple Ile is a 
half-finished canvas, it can understand BASIC commands, store 
copies of programs on disk and perform numerous other input 
and output functions. However, if one just randomly dabbed his 
paint brush around the computer’s memory, a nicely started 
painting could be ruined. 


There area few places not to play around. The most important of 
these is page-zero. Page-zero is where BASIC and DOS store 
important variables about themselves. For example, the location 
of the BASIC program is stored in page-zero. If page-zero must 
be accessed (usually because of the 6502’s indirect addressing 
techniques), locations F9 to FD can always be used safely. 


Keeping this cautionary note in mind, here is how to change the 
contents of memory. First, open the location to be changed. 


*357 
0357-FF 


Now, type a colon followed by the new value you wish to store. 
*:47 
"37 
0357-47 *— new value stored 


These commands can be combined. 
*357:86 
ue og 
0357-86 *— just to check 


Just as there was a shortcut for examining a large block of 
memory, there is also a shortcut for changing large portions of 
memory. To place the values 04 53 F8 8B FF in successive locations 
starting at 3703, enter the following: 


*3703: 4 53 F8 8B FF 
*3703 

3703-04 ~—to check 
*(ret) 

53 F8 8B FF 
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To store data in consecutive memory locations, type the address 
followed by a colon and the data. Each data item should be 
separated with a blank space. The monitor can accept as many 
data values as it can fit on a command line (255 characters). 


The monitor stores the address after the last changed address as 
the opened address. Therefore, to continue entering consecu- 
tive data values, just type a colon followed by the remainder of 
the data. 


*300:12345 

*6789ABCDEF 

*300.30E 

0300-01 02 03 04 05 06 07 08 
0308-09 OA 0B 0c 0D OE OF 


Changing Registers 


When the monitor executes any program using the GO com- 
mand (described later), it first loads the 6502’s registers with the 
values in locations 45 through 49. To alter these values, first 
execute a register examine. 


*CTRL-E 
A=0F X=FC Y=07 P=BO S=11 


Then, type a colon followed by the new values. 
*°12345 
*CTRL-E 
A=01 X=02 Y=03 P=04 $=05 


This command sequence works because the examine register 
command stored 45 as the opened address. 


Move Data 
Suppose that the data which is to be stored in one memory block 


already exists in another memory block. The act of reading that 
data followed by re-entering it would involve wasted effort. The 
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monitor supplies the move, M, command to accomplish this task 
more easily. 


To move a block of data, the monitor must know the data’s 
source as well as its destination. It seems that this would require 
four addresses: the start and end of both the source and 
destination. One of these addresses supplies redundant informa- 
tion, the ending address of the destination. The format of the 
instruction, therefore, is as follows: 


XXXX<YYYY.ZZZZ M 


XXXX stands for the Hex destination starting address. YYYY refers 
to the source starting address. ZZZZ refers to the source ending 
address. The less than symbol can be thought of as a funnel 
which channels data from the source to the destination. 


*300: 000000 
*°000000 

*°0000 

*300.30F 

0300- 00 00 00 00 00 00 00 00 
0308- 00 00 00 00 00 00 00 00 


380: 10 20 30 40 50 60 70 80 
*:90 AO BO CO DO £0 FO FF 
*380.38F 

0380- 10 20 30 40 50 60 70 80 
0388- 90 AO BG CO DO E0 FO FF 


*300 < 380.38FM 

*300.30F 

0300- 10 20 30 40 50 60 70 80 
0308- 90 AO BO CO DO EO FO FF 


Comparing Blocks of Memory 
The monitor's verify, V, command compares two blocks of 


memory. If these two blocks are identical, the monitor will 
return the asterick prompt. If these blocks are not identical, the 
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monitor will display the source address of the discrepancy, its 
contents, and what data should have been there. 


The format of the verify command is identical to that of the move 
command, except for the trailing command letter. 


XXXX<YYYY.ZZ2ZZ V 


XXXX is the starting address of the destination (what the source is 
compared to). YYYY is the starting address of the source, and 
ZZZZ is the ending address of the source. 


*300<E000.EOQOFM 

*300<£000.EOOFV 

*300.30F 

0300- 20 00 FO 4c B3 E2 85 33 
0308- 4C £0 FD 60 8A 29 20 FO 


E000-EOOF contains the same data as 300-30F. 


*308:AA BB 
*300<E000.EOOFV 
E008- 4C (AA) 
E009- ED (BB) 


Because of the manner of which the move and verify commands 
are executed, certain programming tricks are possible. To store a 


pattern of data in memory procede as follows: 


Store the pattern to be replicated in the first position of the 
range. 


*1000: AA BB CC DD 


If N is the number of data values in the pattern, and if SSSS is the 
start address and EEEE is the ending address; enter the following: 


SSSS+N<SSSS.EEEE-N M 
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To replicate AA BB CC DD from 1000 to 103F, enter the 
following: 


*1004<1000.103BM 
*1000.103F 


1000- AA BB CC DD AA BB CC DD 
1008- AA BB CC DD AA BB CC DD 
1010- AA BB CC DD AA BB cc DD 
1018- AA BB CC DD AA BB CC DD 
1020- AA BB CC DD AA BB CC DD 
1028- AA BB CC DD AA BB CC DD 
1030- AA BB CC DD AA BB CC DD 
1038- AA BB CC DD AA BB CC DD 


Verify can be used in a similar manner to determine whether a 
pattern repeats itself in memory. For example, to determine if 
the pattern in the preceding example does indeed exist in 
memory, type the following. 


*1004<1000.103BV 

This command is useful in evaluating whether an area of memory 
has been set to a certain value. First clear page-20. 

*2000:0 

*2001<2000.20FEM 
Next, change the following two locations. 

*2040: 47 

*2080: FF 
Finally, check page-20. 

*2001 < 2000. 20FEV 


203F- 00 (47) 
2040- 47 (00) 
207F- 00 (FF) 
2080- FF (00) 
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The monitor indicates the discrepancy at location 2040 with the 
first two lines of output. It treats the error at 2080 in the same 
manner. 


Saving and Retrieving Data with the Cassette 


The monitor’s write, W, command writes the contents of a range 
of memory locations onto cassette tape. The command syntax is 
straightforward. The command is entered by typing the starting 
address; a period; the ending address; and a W. The following 
example will store the data in locations 1000 to 1040 on cassette 
tape. 


*1000.1040W *— Don’t press the return here 


Note that we did not immediately end the command by pressing 
return. The reason for this was to first allow for the recorder’s 
play/record button to be pressed. Press record, followed by 
return. After return has been pressed, the monitor will write a 10 
second steady tone leader, and will then record the data and the 
checksum. When the recording process has been completed, 
the monitor will cause the console speakers to beep. 


The monitor’s read, R, command is similar in operation to the 
write command. Enter the address of the range where the data is 
to be stored, then type R (again, no return). 


*2000.2040 R 


To ready the cassette for input to the computer, rewind the tape 
to the beginning of the leader tone. A steady tone will be emit- 
ted. Press the recorder’s play key, wait a few seconds, and then 
press return. 


The monitor will read the data and the checksum, and will then 
verify that the data is correct. If no errors are discoverd the 
monitor will respond with a beep. However, if the checksum 
does not match the stored data, the message ERR will be 
displayed. 
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The checksum is a number which the Apple calculates from the 
data when it is saved. This number is unique for any specific data. 
Therefore, if the checksum does not verify when it is read, an 
error most likely occurred when the data was written to the 
cassette. 


Saving and Retrieving Data from Disk 


Unfortunately, the cassette is slow and very prone to errors. 
Therefore most users prefer a disk drive for data storage. How- 
ever, the monitor does not include commands for reading or 
writing to diskette. In order to save assembly code on disk, the 
user must first activate BASIC, Then, the binary save (BSAVE) or 
binary load (BLOAD) commands must be executed in order to 
save or read the data. 


To save the same memory addresses as were saved in the cassette 
example (1000-1040), the following BASIC command would be 
required: 


*CTRL-C *— into BASIC 
] or > BSAVE TXTA,A$1000,L$41 


TXTA is the name of the disk file. A stands for at memory loca- 
tion. L stands for length of memory block. In the preceding 
example, the block of data beginning at address $1000 and 
extending to $1040 would be saved on disk with the filename, 
TXTA. 


To recall this block of data from disk, type: 

] or > BLOAD TXTA,A$2000 
This command will load the file at locations 2000 to 2040. If 
““A$2000” had not been entered on this line, the binary file 
would have been loaded at the same locations from which it had 


been saved (1000-1040). 


It is good practice to verify that data written to the cassette unit 
has been saved accurately. Although errors are encountered 
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with much less frequency on disk writes, it is also good practice 
to verfiy those as well. 


To verify that the machine code has been faithfully reproduced, 
first save the code, using the procedures outlines previously. 
Then, load the information back into the computer, but load it at 
a different address. The monitor’s verify command can now be 
used to compare the two sections of code. If the data had been 
saved correctly, the two sections will be identical. 


*1000.10FF W 
rewind tape 
*2000.20FF R 
*1000<2000.20FF V 


* 


If the verify command causes any addresses and data values to be 
displayed, the save was not successful. If only the asterisk prompt 
was displayed, the save worked perfectly. 


Other Input/Output Commands 


The format in which information is displayed on the screen is 
controlled by the monitor’s Inverse and Normal commands. If 
“VL” is included ina commandline, all monitor inputs and outputs 
displayed thereafter will be displayed in inverse video. This 
process can be reversed by including ‘““N’ as part of asubsequent 
command line. 


*E000 
E000- 4C 
*| E000 N_ £000 


EQ00- 4C ~q————_— inverse video 


E000-4C <<" ) normal 
* 


The monitor's input and output can also be redirected to peri- 
pheral devices. The printer command directs the monitor’s out- 
put. The keyboard command determines the device from which 
the monitor will accept input. The printer and keyboard com- 
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mands perform the same function as the BASIC PR# and IN# 
commands, respectively. 


The syntax for the printer command is as follows: 
*# CTRL-P 


# represents the slot number of the peripheral device to which 
data is to be sent. 


For example, the following commands would dump the con- 
tents of addresses 300 to 3FF to the peripheral device with its card 
in slot #1. 


*1 Ctrl-P 
*300.3FF 


The preceding command causes subsequent monitor output to 
be directed to the device whose card is in slot #1. If you wish to 
redirect output to the screen, you can, do so by executing the 
following command: 


*0 Ctrl-P 


The keyboard command functions in a manner quite similar to 
the printer command, except that data will be accepted from the 
specfied device rather than output to it. The following command 
causes subsequent data to be accepted trom the device whose 
controller card is in slot #1. 


*71 Ctri-K 


Data can again be accepted from the keyboard by executing the 
following command. 


*0 Ctri-K 


The monitor can input and output through a single peripheral. 
For example, suppose a modem is connected to a serial port with 
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its card in peripheral slot #5. The computer could accept infor- 
mation from the modem as well as information to it. By entering 
the following commands, the computer would be instructed to 
use the modem. 


*5 CNITL-P 
*5 CNIL-K 


MACHINE LANGUAGE PROGRAMMING 
Introduction 


The process of writing a machine language program is along and 
tedious one compared to the process of writing a program in 
BASIC. Why then would a programmer wish to write a program 
in machine language? The answer is speed. Machine language 
programs execute at arate anywhere from 10 to 1000 times faster 
than a BASIC program. 


Mini-Assembler 


An assembler greatly facilitates the process of writing a machine 
language program. An assembler translates assembly language 
mneumonics to operation codes which can be executed by the 
microprocessor. Without an assembler, the programmer would 
have to look up each operation code, one-by-one. 


A mneumonic is a short abbreviation for an assembly language 
instructions. For example, JSR is the mneumonic which stands 
for the jump to subroutine operation. The microprocessor does 
not understand mneumonics. It does however understand hex- 
adecimal codes. The purpose of the assembler is to translate a 
mneumonic (ex. JSR) to its equivalent hex value (#20). 


The mini-assembler, built into Integer BASIC, is not full-fledged 
assembler. The mini-assembler does not support labels, nor does 
it remember the source once return has been pressed. The 
mini-assembler merely converts the mneumonic entered in the 
command line into its equivalent hex value(s). 
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The assembler then stores these hex values in memory. The 
original mneumonic entry will be lost. Since the mneumonic is 
not saved inasource file, modification of the machine language 
program would be difficult. 


Activating the Mini-Assembler 


Integer BASIC’s assembler, can be executed by entering the 
following command: 


>CALL -2458 


The mini-assembler could also be called directly from the moni- 
tor as long as Integer BASIC had previously been active. The 
mini-assembler can be loaded from the monitor by executing 
the following command: 


*F666G 


The G denotes the monitor’s G command. This command will be 
explained in detail later in this chapter. 


These two commands are known as the assembler enter com- 
mands. These commands cause a JMP (Jump) to be executed to 
the starting address of the mini-assembler. Once this instruction 
has been executed, the mini-assembler will function and its 
prompt (!) will be displayed. 


Entering the First Program Line 


Once the mini-assembler’s prompt (!) has been displayed, the 
programmer must input a line consisting of the assembly lan- 
guage program’s starting address followed by the first mneu- 
monic instruction. These must be separated by a colon. This is 
shown in the following example. 


1300:JSR FBDD 
0300-20 DD FB JSR $FBDD 
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Entering Subsequent Program Lines 


The assembler is now ready to accept another program line. To 
enter the next instruction in the next consectutive memory 
location, enter a blank space followed by the next instruction. Be 
sure to include the space asitis important. The following is an 
example of the correct syntax for the entry of a subsequent 
program lines. 


! JMP 300 
0303-4C 0003 JMP $0300 


If any errors are encountered in an input line, the assembler will 
cause the speaker to beep and will display an arrow ( \) beneath 
the offending character. 


Asecond error can occur if a branch instruction is attempted ina 
program of more than FF,, bytes. 


Returning to the Monitor 


Suppose the assembler was in use and the programmer wished 
to return to the monitor. This can be accomplished by prefixing 
the monitor command (FF69G) with the $ character as shown in 
the following example. 


!$FF69G 


When §$ prefixes a monitor command while the assembler is 
active, this monitor, is executed. The FF69G monitor command 
executes a jump to the monitor’s starting location. The $ is not 
limited to usage with only FF69G. It can be used with any monitor 
command. 


Converting Assembly Language Hex Codes Back into Mneu- 
monics 


The monitor includes a list command which allows the pro- 
grammer to convert hex data in memory back into mneumonics. 
When the following command is entered: 
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*300L 


The following data will be displayed: 


0300- 20 DD FB JSR $FBDD 
0303- 4C 00 03 JMP $0300 
0306- 00 BRK 

0307- 00 BRK 

0308- 00 BRK 

0309- 00 BRK 

030A-00 BRK 

030B- 00 BRK 

030C-00 BRK 

030D-00 BRK 

030E- 00 BRK 

030F- 00 BRK 

0310- 00 BRK 

0311- 00 BRK 

0312- 00 BRK 

0313- 00 BRK 

0314- 00 BRK 

0315- 00 BRK 

0316- 00 BRK 


The 300 indicates the starting address of the first assembly lan- 
guage instruction (in hex) which is to be converted back into a 
mneumonic. The L indicates the list command. 


In our example, all data displayed after 306 will be random as 
assembly language instructions were only entered at addresses 
300-305 inclusive. 


The L command automatically fills the screen (20 lines) with the 
contents of memory beginning with the address specified as its 
argument. 


When a listing is complete, the monitor stores the last line that 
was listed as the program counter. If the L command is used 
without an argument, the monitor uses the program counter as 
the first line to be listed. Using a series of single L’s, the pro- 
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grammer can conveniently list a program which would fill more 
than one screen. 


Executing a Machine Language Program 


The monitor’s GO command is used to execute a machine lan- 
guage program. 


When GO is executed, the microprocessor’s registers will be 
loaded with the values stored in addresses $45 to $49 as follows: 


@ The microprocessor’s accumulator will be loaded with the 
value stored in address $45. 


@ The X register will be loaded with the value stored in $46. 
@ The Y register will be loaded with the value stored in $47. 


@ The processor status register will be loaded with the value 
stored in $48. 


@ The stack pointer will be loaded with the value stored in $49. 


Once the registers have been loaded, a JSR (Jump to Subroutine) 
command will be executed to the last opened memory location. 


Since the monitor treats all programs as subroutines, a RTS 
(Return from Subroutine) instruction should be the last instruc- 


tion in the program. 


We will illustrate the usage of GO using the following example 
(which you probably have already entered). 


1300:JSR FBDD 
!JMP 300 


Pita program can be executed by entering the following: 


*300 G 
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Once you have started the program, you can stop it by pressing 
Ctrl-Reset. 


This program causes the speaker to buzz. This is accomplished 
using the monitor bell subroutine. This is located at memory 
address FBDD. The second instruction (JMP 300) causes the pro- 
gram to repeatedly jump to the bell subroutine. This results ina 
continuous buzzing being emitted from the speaker. 


The various I/O subroutines are listed in Appendix 1. These can 
be executed via a machine language program. 


Creating a Custom Monitor Command 


The monitor’s CTRL-Y command causes program control to be 
transferred to the instruction at memory location 3F8. Addresses 
3F8-3FF are available for usage by the programmer. Generally, 
because only 8 bytes are available, a JMP instruction will be 
stored at these addresses. However, a machine language pro- 
gram could also be stored there. 


One useful application of the CTRL-Y command is automatic 
execution of the mini-assembler. By storing the following data 
values at locations 3F8-3FA: 


JMP Address F666 
i 
3F8: 4C 66 F6 


CTRL-Y will result in automatic execution of the mini-assembler. 


The programmer could avoid having to enter the preceding 
command by adding the following program line to the DOS 
“Hello” file. This can be accomplished by entering the following: 


JUNLOCK HELLO 

JLOAD HELLO 

]5 POKE 1016, 76: POKE 1017,102:POKE 1018,246 
JSAVE HELLO 

]LOCK HELLO 
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After this entry has been made, upon power-up, the command 
to start the assembler will be resident in location 3F8-3FA. Ctrl-Y 
could then be used to automatically activate the monitor. 


LOOK UP SECTION 
Into/Out of Monitor 
CALL-151 
CNTL-RESET 

CNTL-C 

3D0G 


CNTL-B 


Memory Examine 


nAAN 


Mmmm. AAA 


[return] 


Memory Change 


nnnn: dd, dd,... 


Register Examine 


CTRL-E 


Activates Monitor. 


Returns to BASIC. 
— program and 
variables intact 


Returns to BASIC. 
— program and 
variables erased 


Displays contents of address 
nnnn 


Displays contents of addresses 
mmmm through nnnn 


Displays contents of as many 
as eight addresses following 
the last opened address 


Store data values in consecu- 
tive locations starting with 
nnnn 


Display contents of 6502's reg- 
isters which are loaded prior to 
program execution 
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CTRL-E: dd, dd, dd, dd, dd, 
Move and Verify 


XXxx<yyyy.zZzZzz M 


XXXX<yyyy.Zzzz V 


Saving and Loading Program 


ssss.eeee W 


ssss.eeee R 


BSAVE NAME, A$xxxx,L$yyyy 


BLOAD NAME, A$xxxx 


Input/Output 


N 


# CNTL-P 


Stores values for registers 


Copy contents of range of 
addresses yyyy through 2zzz 
to range starting at xxxx 


Compares the contents of 
addresses yyyy through zzzz 
with the range beginning with 
XXXX. 


Saves contents of addresses 
ssss to eeee onto tape. 


Loads from tape to addresses 
ssss to eeee, 


Saves in disk file ““NAME” con- 
tents of the range of addresses, 
starting at xxxx with length 


y¥Yy: 


Loads memory addresses start- 
ing at xxxx with disk file 
“NAME”. If A$xxxx Is not spec- 
ified, loads at address at which 
data was saved. 


Sets normal display mode. 
Sets inverse display mode. 


Directs output to peripheral 
with card in slot #. 


# CNTL-K 


Mini-assembler 


CALL-2458 
F666G 


$FF69G 
CNTL-RESET 


$ 


Running/ Listing 


nnnn G 


nnonnl 


Your Command 


CNTL-Y 
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Accepts input from peripheral 
with card in slot #. 


Activates assembler 


Activates monitor. 
Activates INT BASIC 


Executes monitor command 
while using assembler. 


Executes machine language 
program at location nnnn 


Disassembles 20 machine lan- 
guage instructions starting at 
location nnnn 


Jumps to machine language 
subroutine at location 3F8. 


CHAPTER 8. 
THE 80-COLUMN BOARD 





Unlike its predecessors, the Apple [le has an additional siot built 
into its motherboard. The slot is called the auxiliary expansion 
slot. This slot accepts one of two peripheral expansion cards. 
One of the cards provides the Apple Ile with extended display 
capability as well as an additional 64K of memory. The other card 
provides only for the extended display. Since the extended 
display capability of both cards is identical, all references to the 
cards in this chapter shall be “The Apple 80-column board”. 


The Apple 80-column board allows the computer to display a full 
80 columns on the screen. It also allows for additional editing 
features, including screen editing. 


The 80-column board can be used with Pascal, CP/M*, or BASIC. 
The 80-column board is automatically switched on whenever 
Pascal or CP/M is used. However, this is not the case with BASIC. 


When using CP/M, all features of the 80-column board are 
automatically activated. When using Pascal, all features except 
the cursor up and cursor down keys are functional. This can be 
remedied through execution of the SET UP program provided 
on the Pascal Disk, Apple 3. 


As mentioned earlier, set up with BASIC is more complex. This is 


due to the fact that the Apple Ile was designed to be software 
compatible with the Apple I! and Apple II+ computers. 


* CP/M is a trade mark of Digital Research. 
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Activating the 80-Column Board in BASIC 


To enable the 80-column board, first power-up the computer as 
usual. Then, after Applesoft has control of the computer, enter 
the following, 


PR#3 


to activate the board. It is usually convenient to depress the 
CAPS LOCK key since Applesoft does not understand lowercase 
letters. 


The statement PR#3 may seem a bit obscure. The PR#3 command 
is executed because the auxiliary expansion slot is hard-wired to 
peripheral slot number three. Recall that PR# is the BASIC 
statement used to activate a peripheral for output. 


Since non-Apple manufactured 80-column boards are tradition- 
ally used in peripheral slot #3, the auxiliary expansion slot has 
been hard-wired to this slot. 


This wiring arrangement has one drawback. If any peripheral 
card is inserted in slot #3, it will be rendered inactive by the 
80-column board. 


The effect of activating the 80-column board is that the screen is 
cleared. Next, the 80-column cursor will be displayed. The 80- 
column cursor is only half as wide as the standard BASIC cursor. 
It is solid instead of checkered, and does not blink. 


Everytime the computer is powered-up, the 80-column card 
must be activated before it is used. This may prove to be quite 
tedious. This tedium is inevitable in a cassette based system. 
However, this situation can be remedied in a disk based system. 


The 80-column board can be activated each time a specific disk is 
used through modification of the HELLO program on that disk. 
The DOS HELLO program is a BASIC program that is executed 
during the power-up procedure. The computer runs this pro- 
gram automatically. The HELLO program contains information 
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used during the power-up procedure. 


Certain parts of this program should not be changed. These parts 
begin with line number 10. This allows only line numbers 0 
through 9 to be used safely for the user’s modification of the 
program. 


The BASIC statement, 
1 PRINT CHR$(4);”PR#3” 


when added to the HELLO program, will cause the 80-column 
board to be activated at power-up. This statement accomplishes 
its task by printing the DOS command PR#3. 


In order to change the HELLO program, first unlock it, then load 
it into the computer. 


] UNLOCK HELLO 
] LOAD HELLO 


Add the following BASIC statement into the program by 
entering it in response to the Applesoft prompt (}). 


] 1 PRINT CHR$(4);”PR#3” 


List the program to verify that line 1 has indeed been entered 
correctly. Finally, save and lock the new HELLO program. 


] SAVE HELLO 
] LOCK HELLO 


Deactivating the 80-Column Board 
When the 80-ccolumn board is activated, output to another 
device is difficult. The disk drive presents no problems, but 


attempting printer output may adversely effect the display. 


In order to output to a printer, the 80-column board must be 
disabled. This is the case even if the 80-column board is in its 
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40-column mode (described later in this chapter). Remember, if 
the cursor is solid and does not blink, then the 80-column board 
Is active. 


To deactivate the board, type the [escape] key, followed by 


CONTROL-Q. 
ESC CONTROL] - Q 


The screen will revert to a 40 column display, and the blinking 
checkerboard cursor will return at the bottom of the screen. 


CONTROL-RESET will also deactivate the 80-column board. 
However, the user is advised against this technique. The use of 
CONTROL-RESET while the 80-column board is active will 
disrupt display, and may cause the erasure of any RAM-resident 
programs. 


Selecting 40 or 80 Columns While Board is Active 


Occasionally, a 40-column display may be desirable. However, it 
may not be desirable to forfeit the extra editing capability of the 
Apple 80-column board. This dilemma may be resolved via the 
use of the 40-column mode of the Apple 80-column text board. 
In the 40-column mode, the text board is active, although only 40 
columns are displayed. 


A switch to the 40-column display can be accomplished by either 
of two commands. Typing CONTROL-Q, while the board is 
active will enable the 40-column mode. Notice that an escape 
does not precede the CONTROL-Q. Upon receipt of this 
command, the computer will display any text which had pre- 
viously been displayed in the leftmost 40-columns of the 80- 
column display. The width of each character will be doubled. 
Pressing the escape key, followed by pressing the 4 key, causes 
identical results. 


Either CONTROL-R or escape,8 will return the display to the 
80-column mode. Any text that had been displayed in the 40- 
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column mode will be redisplayed in the leftmost 40-columns of 
the 80-column display. The right hand side will be cleared. 


The following four commands may also be used in programs to 
change the display mode during program execution. 


oP ESC 4 Select 
CONTROL-Q 40-column mode 
ESC 8 Select 

or 


CONTROL-R 80-column mode 


Moving the Cursor 


The 80-column board comes equipped with numerous editing 
features. These features can be implemented through the use of 
the ESC and CONTROL keys. When using a control command, 
the CONTROL key must be held down before another key is 
pressed. When using an escape command, the ESC key must be 
pressed and released before another key can be pressed. 


The easiest editing keys to understand are undoubtedly the 
arrow keys. When in the escape mode, these keys allow the 
cursor to be moved across the display field, without destroying 
any of the text already displayed. This allows the user to edit text 
anywhere on the screen. The escape mode is entered by pressing 
the ESC key. It is exited by pressing the space bar. While in the 
escape mode, the cursor becomes an inverse video plus sign. 


While in the escape mode, the I, J, K, and M keys perform the 


same function as the up-arrow, left-arrow, right-arrow, and 
down-arrow keys, respectively. 


M 


The four keys, A, B, C, and D may also be used to accomplish 
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cursor movement. However, after a single keystroke, the com- 
puter automatically exits the escape mode. 


D 
B=<— A 
C 


Moving the cursor up one row would require either of the 
following key sequences: 


asi FSC OD 
FSC f SPACE 

To move the cursor up four rows would require either of the two 

following key sequences. 


FC D ESC D ESC D ESC D 
ESC. of i i { SPACE 


Use of ESC,D is cumbersome for cursor moves of more than a 
few rows. The same idea applies to the use of ESC,A, ESC,B, and 
ESC,C. 


Editing Functions that Clear Parts of the Display 


It is often necessary to clear all or parts of a display, so that new 
information can be displayed rieatly. The simplest of the com- 
mands in this category is the Clear Screen command. When a 
CONTROL-L is issued, either through the keyboard cr in a 
program, the display is cleared and the cursor is positioned in the 
upper tefthand corner of the screen. 


CONTROL-L clear screen 
A similar command is the “clear to end of screen” command. 


When the CONTROL-K command is used, the screen is cleared 
from the current cursor position to the end of the screen. The 
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position of the cursor remains unchanged. 
CONTROL-K clear to end of screen 


In order to clear only a specific row, the CONTROL-Z command 
is used. When this command is issued, the row in which the 
cursor resides is cleared. The cursor position remains un- 
changed. 


CONTROL-Z clear line 


The CONTROL-] command will clear the line in which the cursor 
resides from the current cursor position to the end of that line. 


CONTROL-] clear rest of line 
Scrolling the Display 


The entire screen display can be scrolled up or down, without 
moving the cursor position. If any information is scrolled off 
either end of the screen, that test will be lost. 


CONTROL-V scroll down 
CONTROL-W scroll up 


Use of CONTROL Codes from BASIC 


All of the screen editing features of the 80-column board may be 
implemented through BASIC. These features are used by print- 
ing the escape or control character. Since the characters cannot 
be entered directly into PRINT statements from the keyboard, 
the CHR$ function must be used to generate the control 
characters. 


The ESCAPE codes are generally not used in programs because of 
their complexity. 


The following example uses the scroll up and scroll down 
commands. 
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10 HOME:HTAB 15 

20 PRINT “BOUNCING” 

30 FOR I =1 TO 20 

40 PRINT CHR$(22); «—— scroll down 
50 NEXT | 

60 FOR | =1 TO 20 

70 PRINT CHR$(23); «—— scroll up 
80 NEXT | 

90 GOTO 30 


Table 8-1. CONTROL Codes 


CONTROL Equiv. ESC 
Code Code ASCII Function 


ring bell 

backspace 

line feed 

clear to end of screen 

clear screen 

return 

set normal display 
(only in program) 

set inverse display 
(only in program) 

set 40-column mode 

set 80-column mode 

deactivate 80-column 
board (in program) 

scroll up 

scroll down 

home (no clear) 

clear line 

forward space 

clear to end of line 
































4 
8 
CONTROL-Q 
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BASIC Support of the 80-Column Board 


The 80-column board does not effect the functioning of the 
majority of BASIC’s majority commands. Only four of the 
commands function differently when used with the 80-column 
board. These are as follows: 


HOME 
FLASH 
HTAB 
INVERSE 


Tabbing 


Horizontal tabbing, while using the 80-column board, does not 
operate in exactly the same manner as it does without the board. 
If the numeric argument of the HTAB function is greater than 40, 
an automatic wrap-around occurs. If an HTAB is attempted to 
any of the columns greater than 40, an automatic wrap-around 
occurs even though the display is capable of 80 columns. 
Therefore, nothing is displayed in the last 40 columns. 


This is remedied by the substitute HTAB command. This com- 
mand is as follows: 


POKE 1403,XX 


XX represents the column number to which the next screen 
output will be directed. HTAB XX may still be used for the first 40 
columns if the programmer so desires. The substitute command 
will only operate correctly when the 80-column display is being 
used. 


100 VTAB 5 
110 POKE 1403,65 
120 PRINT “OUTPUT” 


Execution of the previous example will output the text, OUTPUT, 
at screen location 65,6 (65th column, 5th row). 
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Use of INVERSE, FLASH, and HOME 


The FLASH command is not supported by the 80-column board. 
However, FLASH can be used while the 80-column board is 
inactive. If FLASH is active during the activation of the 80-column 
board, the screen will turn white, and LIST’ing a program may 
return an unintelligible result. To recover, enter the NORMAL 
command. 


The 80-column board extends the INVERSE capability of the 
Apple lle to include lowercase letters. Without an active 80- 
column board, only capital letters can be displayed in INVERSE 
video. 


The HOME command works as usual, with one exception. This 
exception occurs if the computer is in the inverse mode when 
the HOME command ts issued. While the 80-column board is 
inactive, the HOME command causes the screen to be black- 
ened, but all subsequent output will appear in INVERSE video. 
However, while the board is active, the HOME command causes 
the entire screen to be colored white, with all subsequent output 
in INVERSE video. 


Uppercase-Restrict Mode 


A very convenient feature of the 80-column board is the 
uppercase-restrict mode. Upon entering this mode, all lower- 
case entries will be interpreted as capital letters, unless they are 
entered between quotation marks. This feature relieves the 
programmer of the tedium of repeatedly pressing the CAPS 
LOCK key. 


ESC,R activates uppercase-restrict 
ESC,T deactivates uppercase-restrict 


When programming, the uppercase-restrict mode is useful for 
the entry of PRINT statements. BASIC requires that all com- 
mands be in capital letters. It is often desirable to have a program 
output in both lowercase and uppercase letters. Without an 
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uppercase-restrict mode, a program line such as, 
10 PRINT “Tucson, Arizona” 


would have been very difficult to enter. The uppercase-restrict 
mode allows the line to be entered using the SHIFT key only 
twice. 
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APPENDIX A. APPLESOFT BASIC RESERVED WORDS & TOKENS 


ABS 
AND 
ASC 


ATN 
CALL 
CHR$ 
CLEAR 
COLOR= 
CONT 
COS 
DATA 
DEF 
DEL 
DIM 
END 
EXP 
FLASH 


FOR 
FRE 
GET 
GOSUB 
GOTO 


HCOLOR= 


HGR 
HGR2 
HIMEM: 
HLIN 
HOME 
HPLOT 


(212) 
(205) 
(230) 
(197) 
(225) 
(140) 
(231) 
(189) 
(160) 
(187) 
(222) 
(131) 
(184) 
(133) 
(134) 
(128) 


HTAB 

IF 

IN# 
INPUT 
INT 
INVERSE 
LEFT$ 
LEN 

LET 

LIST 
LOAD 
LOG 
LOMEM: 
MID$ 
NEW 
NEXT 
NORMAL 
NOT 


NOTRACE 


RECALL 


(150) 
(173) 
(139) 
(132) 
(211) 
(158) 
(232) 
(227) 
(170) 
(188) 
(182) 
(220) 
(164) 
(234) 
(191) 
(130) 
(157) 
(198) 
(156) 
(180) 
(165) 
(206) 
(216) 
(226) 
( 


(141) 


(185) 
(161) 
(217) 
(186) 
(138) 
(135) 
(167) 


REM 
RESTORE 
RESUME 
RETURN 
RIGHT$ 
RND 
ROT= 
RUN 
SAVE 
SCALE= 
SCRN( 
SGN 
SHLOAD 
SIN 

SPC( 
SPEED= 
SQR 
STEP 
STOP 
STORE 
STR$ 
TAB( 
TAN 
TEXT 
THEN 
TO 
TRACE 
USR 
VAL 
VLIN 
VTAB 
WAIT 
XDRAW 


(178) 
(174) 
(166) 
(177) 
(233) 
(219) 
(152) 
(172) 
(183) 
(153) 
(215) 
(210) 
(154) 
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APPENDIX B. INTEGER BASIC RESERVED WORDS 


ABS END LET PDL SAVE 
AND FOR LIST PEEK SCRN 
ASC GOSUB LOAD PLOT SGN 
AT GOTO LOMEM: POKE STEP 
AUTO GR MAN POP TAB 
CALL HIMEM: MOD PRINT TEXT 
COLOR= — HLIN NEW PR# THEN 
CON IF NEXT REM TO 
DEL IN# NOT RETURN TRACE 
DIM INPUT NOTRACE RND VLIN 
DSP LEN OR RUN VTAB 
APPENDIX C. DOS RESERVED WORDS 
APPEND CHAIN INIT POSITION SAVE 
BLOAD CLOSE LOAD READ UNLOCK 
BRUN DELETE LOCK RENAME — VERIFY 
BSAVE EXEC OPEN RUN WRITE 
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Appendix D. APPLESOFT BASIC ERROR MESSAGES 


When an error occurs in Applesoft BASIC, an error message will 
appear, and the program will return to the command level (i.e. 
the ] prompt will appear). The error message will be displayed 
using the following configuration: 


? name ERROR IN line 


where name indicates the error name and line denotes the line 
number where the error occured. If the error occurred in the 
immediate mode, line will be omitted. 


The program listing in memory is not affected by an error nor are 
the stored variable values. However, all GOSUB and FOR loop 
counters are reset to 0. 


When an error does occur, the error’s code will be stored in 
memory address 222. By PEEKing this address, the error code can 
be determined. 


The various Applesoft errors are discussed in the following table. 


Error er 


‘BAD SECTOR 107. | The program referenced an array 
ERROR element with a subscript not 
defined in a DIM statement. 




























(CAN'T CONTINUE 
ERROR 


This error occurs when the program 

attempted one of the following: 

@ Execution of CONT when a 
program was not present in RAM. 

@ Execution of CONT after the 
occurrence of a program error. 

@ Execution of CONT after the 

program had been edited. 









(DIVISION BY 
ZERO ERROR 


Division by zero is not allowed. 
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Error poate 


?7FORMULA TOO This error indicated that a string 
COMPLEX ERROR expression was used that was too 
complex for Applesoft BASIC to 
comprehend. The expression should 
be broken into 2 or more parts. 
























“ILLEGAL DIRECT 
7ERROR 


A statement was used in the imme- 
diate mode which is only allowed 
in the program mode (ex. INPUT, 
GET, DEF FN). 












¢ILLEGAL 
QUANTITY ERROR 






A value was used with a math or 
string function that was out of 
range. 
















gNEXT WITHOUT 
FOR ERROR 


This error willbe generated when a 
NEXT statement is encountered 
without a corresponding FOR state- 
ment. This error is often the result 
of different variables being used | 
with FOR and NEXT. 














?OUT OF DATA 
ERROR 


A READ statement was executed 
which contained variables for which 
DATA statement values were not 
available. 
















This error can be the result of any 
of the following: 

@ LOMEM: set too high. 

@ HIMEM: set too low. 

@ Use of a program that was too 
large for available memory. 

@ Use of excessive nesting of FOR, | 
NEXT loops, GOSUBS, or paren- 
theses. 

@ Use of an overly complicated 

expression. 

Use of too many variables. 






“OUT OF MEMORY 
ERROR 
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Error 
Error Message Error Description 


?7REDIM’D ARRAY 120 JA second DIM statement for an 
ERROR array was encountered after that 
array had already been dimen- 
sioned. This error usually occurs 
when an array had been previously 
dimensioned by default and a DIM 
statement was subsequently exe- 
cuted for the same array variable. 



























A RETURN statement was executed 
which did not have a correspon- 
ding GOSUB statement. 


“RETURN 
WITHOUT GOSUB 
ERROR 






















¢STRING TOO 
LONG ERROR 


A statement attempted to conca- 
tenate two or more strings with a 
resultant string in excess of 255 
characters. 





The statement used an incorrect 
spelling, incorrect punctuation, 
illegal character, etc. 


(SYNTAX ERROR 











?TYPE MISMATCH 
ERROR 


A numeric value was indicated 
where a string value should have 
been used or vice versa. 
















A user-defined function was refer- 
enced which has not been defined 
using DEF FN. 


?7UNDEF’D 
FUNCTION ERROR 









?UNDEF’D 
STATEMENT ERROR 


An attempt was made to branch to 
a line number that did not exist. 
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APPENDIX E. INTEGER BASIC ERROR MESSAGES 


***BAD BRANCH _ |The statement attempted to branch to a 
ERR line number which does not exist. 
















A NEXT statement was executed without a 
corresponding FOR. 


***BAD NEXT ERR 
























A RETURN statement was executed with- 
out a corresponding GOSUB statement. 


***BAD RETURN 
ERR 





***DIM ERR An attempt was made to dimension an 
array that had previously been dimen- 


sioned. 


***MEM FULL ERR 





An insufficient amount of memory is 
available. 


An END statement should be included as 
the last program line in Integer BASIC 
programs. 





***NO END ERR 


***RANGE ERR 















This error is generated when an array 
variable is used with an illegal subscript 
(i.e. a subscript larger than that for which 
the array was DIM’ed). This error is also 
generated when an illegal argument ts 
used in HLIN, VLIN, PLOT, TAB, or VTAB. 


RETYPE LINE 





This message is displayed when an illegal 
entry was made in response to an INPUT 
statement. 





***STRING ERR This message can be generated by almost 


any illegal string operation. 
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***STR OVFL An attempt was made to assign a string a 
ERROR greater number of characters than it had 
been dimensioned for. 


***SYNTAX ERROR |The statement used an incorrect spelling, 
incorrect punctuation, illegal character 


etc. 


***TOO LONG This error occurs when over 128 characters 

ERROR are included on a single statement line or 
when over 12 parentheses have been 
nested. 
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APPENDIX F. DOS ERROR MESSAGES 


When a DOS error is encountered in the context of an Applesoft 
program, the corresponding DOS error code will be placed in 
memory address 222. The error code can be determined by 
executing PRINT PEEK(222). 


Error 


DISK FULL This error occurs when a new file 
or new data ts to be written to a 
disk on which insufficient space is 
available to store the new informa- 
tion. 


END OF DATA This error is generated when a 
READ statement tries to read be- 
yond the end of a text file. 


FILE LOCKED The program attempted to execute 
a WRITE, DELETE, RENAME, SAVE, 
or BSAVE statement with a locked 
file. 


FILE NOT FOUND A file is refrenced which does not 
exist on the diskette. This error 
condition usually occurs as the 
result of using an incorrect file- 
name. 


FILE TYPE An incorrect file type was used 
MISMATCH with a DOS command. 


BLOAD, BSAVE, and BRUN can 
only be used with binary files. 
CHAIN can only be used with 
Integer BASIC program files. 
LOAD, RUN, and SAVE can only 
be used with program files. 
PEN, READ, WRITE, APPEND, 
EXEC, and POSITION can only 
be used with text files. 





Appendix F 293 


Error Seas 
E 
rror Message Code Error Description 


I/O ERROR 












A disk access operation was un- 
successful. This error is generally 
caused by one of the following: 

@ Drive door open. 

@ Diskette not inserted in drive. 

@ Diskette not initialized. 

® Defective diskette. 
















LANGUAGE NOT 
AVAILABLE 






The operator attempted to access 
Integer or Applesoft BASIC when 
that language was not available. 
This error is also generated by 
attempting to load or runa program 
when the program’s language was 
not available. 
















All available file buffers are in 
use. 


NO BUFFERS 
AVAILABLE 
















NOT DIRECT 
COMMAND 


The following DOS commands 
cannot be executed in the imme- 
diate mode, and can only be 
executed within a program: 
APPEND 

POSITION 

OPEN 
READ 
WRITE 



























A DOS command tried to load a 
program file from the diskette into 
RAM when insufficient memory 
was available for the program file. 


PROGRAM TOO 
LARGE 







RANGE ERROR An illegal parameter was specified 
with a DOS parameter. This error is 
generally due to an incorrect drive, 


slot, or volume specification. 
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Error 


SYNTAX ERROR A filename or parameter was mis- 
spelled or incorrect punctuation 
was used. 




















The volume parameter specified 
differs from the volume number of 
the diskette being accessed. 





WRITE PROTECTED DOS attempted to access a write 
protected diskette via one of the 
following commands: 

@ SAVE 

@ BSAVE 


@ WRITE 
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APPENDIX G. ASCII CHARACTER SET 


Dec. | Hex 
Character | Value | Value | Keystroke 


Ctrl-@ 
Ctrl-A 
Ctrl-B 
Ctrl-C 
Ctrl-D 
Ctrl-E 
Ctrl-F 
Ctrl-G 
Ctrl-H 
Ctrl-l 
Ctrl-J 
Ctrl-K 
Ctrl-L 
Ctrl-M 
Ctrl-N 
Ctrl-O 
Ctrl-P 
Ctrl-Q 
Ctrl-R 
Ctrl-S 
Ctrl-T 
Ctrl-U 
Ctrl-V 
Ctrl-W 
Ctrl-X 
Ctrl-Y 
Ctrl-Z 
ESC 
Ctri-\ 
Ctrl-] 





































ON Oo hw Kh | © 





Ctrl-Shift-- 


This appendix lists ASCII] codes 0 through 127. ASCII codes 128 
through 255 repeat codes 0 through 127. 
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Dec. Hex 
Character | Value | Value | Keystroke 


Space Bar 
Shift-1 
Shift-’ 
Shift-3 
Shift-4 
Shift-5 
Shift-7 


Shift-9 
Shift-0 
Shift-8 
Shift-= 


WON HUA WH S| oO” 


/ 
0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


| Shift-; 
Shift-, 


Shift-. 
Shift-/ 


~~) vy iI a ‘8 Pay 
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Dec. | Hex 
Character | Value | Value | Keystroke 





“7 SNS eS eet AD VOZ< A SLO OS 
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Dec. | Hex 
Character | Value | Value | Keystroke 
: 96 60 









Sx SH Cae ADS O2Z oR Loe eae 





Shift-[ 
Shift-\ 
Shift-] 
Shift- 
Delete 


pe ee Oe ee OB SS Se ee oe Oe Oe oe 
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APPENDIX H. APPLE Ile PRINTER USAGE 
INTRODUCTION 


The Apple Ile outputs data to the printer just as it does to the 
screen. To send data to the printer, a PR# statement specifying 
the printer card’s slot number must be executed to cause data to 
be output to the printer rather than to the screen. A second PR# 
statement must be executed if data is to subsequently be sent to 
the screen rather than the printer. 


Either a parallel or serial printer can be used with the Ile using a 
parallel or serial interface card respectively. Generally, the printer 
card is placed in either slot 1 or 2. 


Printer Control Codes 


Generally, printer output can be modified through the use of 
control codes. These codes are generally output to the printer via 
the PRINT statement. Printer control codes can be used to change 
the page length, line length, character size, character set, as well as a 
number of other features. 


In the example at the end of this section, the form feed character is 
sent to the printer in line 170 and the character indicating 
condensed characters is sent in line 190. 


Notice that the CHR$ function is used to send the printer control 
characters. Since, CHR$ is not available in Integer BASIC, the printer 
control codes must be output in some other manner. This is 
generally accomplished by keying in the control code character 
within a pair of quotation marks. Generally, the control code is 
non-printing, so the keystrokes will not be echoed on the screen. 


If our example program was written in Integer BASIC, lines 170, 190 
and 195 would be modified as follows to send the form feed 
character, output condensed characters, and turn off the con- 
densed character mode. 
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170 PRINT ” ” 
Re ress Ctrl 
EE ae Press Ctrl-O 
190 PRINT ” "; “THIS IS AN EXAMPLE OF 
CONDENSED CHARACTER PRINTING” 


195 PRINT ” ” 
fe Press Ctrl-R 


Sending Program Listing to the Printer 


The LIST statement causes program listings to be sent to the screen. 
However, these can alternatively be sent to the printer by preceding 
LIST with a PR# command. 


Example Program 


50 REM THIS EXAMPLE UTILIZED AN EPSON PRINTER 

100 REM THIS EXAMPLE MAY NOT WORK IF YOUR ARE 
USING A DIFFERENT PRINTER 

110 REM DISPLAY DATA ON THE SCREEN 

120 PRINT "THIS IS AN EXAMPLE OF SCREEN OUTPUT” 

130 REM OUTPUT DATA VIA PRINTER AS 
NORMAL CHARACTERS 

140 PR#1 

150 PRINT “THIS IS AN EXAMPLE OF PRINTER OUTPUT” 

160 REM SEND FORM FEED CHARACTER (FF) TO PRINTER 

170 PRINT CHR¢$ (12) 

180 REM SEND CONDENSED CHARACTER CODE (SI) TO PRI 

190 PRINT CHR¢$ (15); “THIS IS AN EXAMPLE OF CONDENSED 
CHARACTER PRINTING” 

195 PRINT CHR¢$ (18) 

200 REM SEND OUTPUT TO SCREEN 

210 PR#0 

220 PRINT “DATA IS AGAIN OUTPUT TO THE SCREEN” 

230 END 
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Appendix I. Machine Language Subroutines 


The Apple Ile’s operating system has been written as a series of 
subroutines. These subroutines can easily be used in the user’s 
own programs. In order to use these subroutines, load the 6502’s 
registers with any necessary data. Then execute a jump to 
subroutine (JSR) to the subroutine’s starting address. 


Although the starting addresses and functions of the monitor 
subroutines are identical in the Apple Il+ and Apple Ile, the 
routines themselves are not. For this reason, if a program is to be 
compatible with both machines, it must only call monitor 
subroutines at their starting address. 


The descriptions of the subroutines will be as follows. 


NAME (address) A=00 X=00 Y=00 
description 


The values of the 6502’s accumulator (A), X-register (X), and 
Y-register (Y) after the execution of the routine are given on the 
same line as the name and starting address. A’"??” indicates that 
the register’s contents have been scrambled. A”--” indicates that 
the subroutine has not changed the contents of that register. 
Hex values shall be indicated with a prefix of "$”. 


BELL ($FF3A/65338) A=$87 X=-- =-- 


BELL writes the CONTROL-G (bell) character to the current 
output device. 


BELL1 ($FBDD/64477) A=??2 X=2? = __ 


BELL1 generates a 1000 Hz tone with a duration of 0.1seconds on 
the console speaker. 
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CLREOL ($FC9C/64668) A =?? =-- Y=? 


CLREOL clears the text line in which the cursor resides, from the 
cursor position to the end of line. 


CLREOP ($FC42/64578) A=??X=-- Y=? 


CLREOP clears the text window from the current cursor position 
to the bottom of the screen. 


COUT ($FDED/65005) A=??2 X=? Y =2? 


COUT calls the character output subroutine. The character 
output subroutine (usually COUT1) must have its starting ad- 
dress in locations ($36-$37). The character to be output should be 
in the accumulator. 


COUT1 ($FDFO/65008) A=?2?2 X=?? Y=?? 


COUT1 displays the character to be output (accumulator) onthe 
screen. The character will be displayed at the current cursor 
position. Afterwards, the cursor position will be advanced. 
COUT1 takes care of control characters, return, linefeed, and 
bell. 


CROUT ($F D8E/64910) A=-- X=-- Y=-- 


CROUT outputs a carriage return ($0D) to the current output 
device. 


GETLN ($FD6A/64874) A=-- X=lengthofline Y=-- 


GETLN accepts an entire string of characters, storing them inthe 
input buffer ($200). The prompting character should be stored in 
location $33. The X-register will contain the length of the string 
upon return from the subroutine. 


GETLNZ ($FD67/64871) A= -- X=length of input Y =-- 


GETLNZ sends a carriage return to the output device, and then 
calls GETLN. 
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GETLN1 ($F D6F/64879) A=-- X=lengthofinput Y=-- 


GETLN1 is the same as GETLN, except that no prompt is 
displayed. If the input line is cancelled, either because of too 
many backspaces or a CONTROL-X, then GETLN will be exe- 
cuted using the prompt in location $33. 


HOME ($FC58/64600) =-- X=-- = 


HOME clears the screen and positions the cursor in the upper 
left corner of the screen. 


IOREST ($FF3F/65343) A=??? X=??? Y=2? 


IOREST restores the 6502’s internal registers to the values stored 
in locations $45 to $49. 


IOSAVE (FF4A/64354) A=??2 X=?? Y=- 


IOSAVE stores the contents of the 6502’s registers into locations 
$45 through $49. 


KEYIN ($FD1B/64795) A=inputted key X=-- Y=-- 


KEYIN pauses for a keypress and then stores the key in the 
accumulator. KEYIN also randomizes the random number seed 
at locations $4E and $4F. 


MOVE ($FE2C/65048) A =?? = -- =-- 


MOVE is identical to the monitor’s move subroutine. MOVE gets 
its argument from: 


@ $42-$43 destination address 
@ $3C-$3D starting source address 
@ $3E-$3F ending source address 


PRBL2 ($F94A/63818) A=-- X=??2 Y=-- 


PRBL2 outputs from 1 to 256 blanks to the current output device. 
The X-register should be loaded with the number of blanks to 
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output before executing this subroutine. X = 00 corresponds to 
256 blanks. 


PRBYTE ($F DDA/64986) A=?? X=-- Y=-- 


PRBYTE outputs the hexadecimal value stored in the accumula- 
tor to the current output device. 


PREAD (FB1E/64286) A=?? X=-- Y =value of controller 


PREAD reads the hand control specified in the X-register (0-3). It 
then returns that value in the Y-register. 


PRHEX ($FDE3/64995) A=?? X=-- Y=-- 


PRHEX outputs the lower nibble of the accumulator, one hex 
digit, to the current output device. 


PRNTAX ($F941/63809) A=?? X=-- =—- 


PRNTAX outputs a four digit hex number. The upper two digits 
must be stored in the accumulator. The lower two digits must be 
stored in the X-register. 


RDCHAR ($FD35/64821) A=2?? X=2?? Y=?? 


RDCHAR is another input subroutine that retrieves characters 
from the standard input subroutine. RDCHAR also interprets 
ESCAPE codes. 


RDKEY ($FD0C/64780) A =character =~ Y=-- 


RDKEY calls the input subroutine. The input subroutine’s 
starting address must be stored in locations $38-$39. This routine 
is usually KEYIN. 


READ ($FEFD/65277) A=2?? X=2?? Y=2?? 


READ converts a series of tones into digital data and then stores 
this data. The following locations must contain pointers before 
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calling the subroutine. 


e $3C-$3D first byte to store data in. 
@ $3E-$3F last byte to store data in. 


READ also computes and verifies the checksum. The checksum is 
calclated with a running exclusive-OR. 


SETINV ($FE80/65152) =-- =-- Y=$3F 


SETINV sets the display format of all successive characters to 
inverse video. 


SETNORM ($FE84/65156) A =-- =-- Y= $FF 


SETNORM sets the display format of all successive characters to 
normal. 


VERIFY ($FE36/65078) A=?? X=2?? Y=2? 


VERIFY is identical in operation to the monitor’s verify com- 
mand. Before execution of this command, certain pointers must 
be set up. 


@ $42-$43 destination address 
e $3C-$3D starting address 
@ $3E-$3F ending source address 


WAIT ($FCA8/64680) A=00 X=-- Y=-- 


WAIT causes a delay of a specific amount of time. The length of 
this delay must be loaded into the accumulator. The delay time is 
calculated using the following formula. 


Delay = %2(26 + 27A + 5A2) microseconds 


WRITE ($FECD/65229) A=?? X=?? Y=?2?? 


WRITE converts digital data into a series of tones for the cassette. 
Two pointers must be set up before calling WRITE. 


© $3C-$3D address of first data byte 
@ $3E-$3F address of last data byte 
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This subroutine also writes a ten second leader and computes a 
checksum. 


Monitor Subroutines -- Graphics 


The monitor contains subroutines that can be used to manipu- 
late the graphics display. 


CLRSCR (($F832/63538) A=?? X=-- Y=?2? 


CLRSCR clears all 48 lines of the low resolution graphics screen 
to black. 


CLRTOP ($F836/63542) A=?2 X=-- Y=?? 


CLRTOP clears the low resolution graphics display. However, 
CLRTOP only clears the top 40 lines. 


HLINE ($F819/63513) A=2?? X=-- Y=? 


HLINE plots a horizontal string of pixels of the color set by 
SETCOL or NEXTCOL. HLINE is used only with a low resolution 
display. Prior to calling HLINE, the accumulator must be loaded 
with the vertical coordinate; the Y-register must be loaded with 
the leftmost horizontal coordinate; and memory location $2C 
must be loaded with the rightmost horizontal coordinate. 


NEXTCOL ($F85F/63583) A=-- X=-- Y=-- 


NEXTCOL adds 3 to the current low resolution color. 


PLOT ($F800/63488) A=?? X=-- Y=-- 


PLOT sets a certain pixel of the low resolution screen to the color 
last selected by SETCOL or NEXTCOL. The vertical position is 
loaded into the accumulator. The horizonal position is loaded in 
the Y-register. 
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SCRN ($F871/63601) A-=color of block X=-- Y=-- 


SCRN reads the color value at a specific location on the low 
resolution graphics screen. SCRN places this value into the 
accumulator. The accumulator shold be loaded with the hori- 
zontal position. The Y-register should be loaded with the vertical 
position. 


SETCOL ($F864/63588) =-- X=-- Y=-- 


SETCOL sets the current low resolution color to the value in the 
accumulator. The colors and their corresponding values are 
listed in Table 6-1. 


VLINE ($F828/63528) A=?? X=-- Y=-- 


VLINE plots a vertical string of pixels of the color set by SETCOL 
or NEXTCOL. VLINE is used with the low resolution display. Prior 
to calling VLINE, the accumulator must be loaded with the top 
vertical coordinate; the memory location $2D must be loaded 
with the bottom vertical coordinate; and the Y-register must be 
loaded with the horizontal coordinate. 


WSI ($F3F2/62450) A=?? X=?? Y=?? 


WSI clears the currently used high resolution screen. WSI clears 
all 192 lines whether or not a text window is being used. 


WSI1 ($F3FA/62454) A=2?? X=?? Y=?? 


WSI1 sets the currently used high resolution screen to the most 
recently plotted color. The subroutine will not work from BASIC 
unless preceded by a plot. 
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APPENDIX J. PROGRAMS ON THE SYSTEM MASTER DISKETTE 


An Applesoft greetings program which is 
automatically run by DOS. 











APPLESOFT An Integer BASIC greetings program 
which is automatically run by DOS if 


Applesoft is unavailable. 





BOOT13 A binary program which allows the usage 


of 13 sector diskettes. 


A binary program that allows one Apple- 
soft BASIC program to be loaded and 
run from within another Applesoft BASIC 
program file. 
























CONVERT13 An Applesoft BASIC program that runs 
MUFFIN, which tn turn converts 13- 


sector diskettes to 16-sector diskettes. 





COPY Used in Integer BASIC to copy diskettes. 





COPY-OB}J0 A machine language subroutine called 


by COPY and COPYA. 





COPYA Used in Applesoft BASIC to copy disk- 


ettes. 


Used by FILEM. 





Applesoft program which allows the user 
to perform a number of DOS functions 
via a main menu. 


FPBASIC 





Binary disk file of Applesoft BASIC. 
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INTBASIC Binary disk file of Integer BASIC. 
LOADER.OB]} Loads Integer BASIC into RAM. 
MASTER Applesoft program which runs the 


binary program MASTER.CREATE. 


MASTER.CREAT Used to create system independent disk- 
ettes. 


MUFFIN Binary program used to convert diskettes 
from 13-sector to 16-sector format. 


RENUMBER Applesoft program used to merge two 
program files or renumber a program's 
lines. 

SLOT# Applesoft program which identifies the 


defaults for slot and drive number. 


START13 Applesoft program which runs BOOT13 


INDEX 


ABS 82 

Absolute Value 82 

Accumulator 267 

Alternative Character Set 20 

AND 59-61,82-84 

APPEND 218-219 

Apple Computer Inc 11 

Apple 80-Column Board 273-283 

Apple If 11 

Apple Ile 11, 13 

Apple lle, cassette input jack 22 

Apple Ile, cassette output jack 22 

Apple Ile, cassette recorder 169-170 

Apple Ile, controller cards 24-25 

Apple He, disk drive 169-224 

Apple Ile, power supply 17 

Apple He, rear panel 15 

Apple Ile, speaker 17-18 

Apple lie, system 12 

Apple lle, video display 18-22 

Apple Writer 28 

Applesoft BASIC 11, 14, 27, 39, 169 

Applesoft BASIC, error messages 
287-289 

Applesoft BASIC, prompt 32, 39, 188 

Applesoft BASIC, switch to Integer 
188 

Applesoft BASIC, tokens 285 

Applications Programs 27-28 

Arithmetic Expressions 54, 57 

Arithmetic Operators 56 

Arrays 52, 95-96, 171 

ASC 72, 78, 84 

ASC! Code 84, 87, 295-298 

Assembler 26-27 

Assembly Language 27 

Assignment Statements 62, 120 

ATN 84-85 

AUTO 72-73, 85-86, 124 

Autostart Boot 185 

Auxiliary Expansion Slot 273 

Auxiliary Slot 14 


B Parameter 224 

BASIC 273 

BASIC Diskette 181 

BASIC, Applesoft 11, 14, 27, 39, 169 
BASIC, functions 75 

BASIC, Integer 11, 27 
BASICS Diskette 181 

Bits 16 

BLOAD 210-21, 260,270 
Boolean Expression 52, 82 
Boolean Operators 56, 59-61 
Branching Statement 72 
BRUN 211 

BSAVE 210, 243-244, 266, 270 
Byte Parameter 224 

Bytes 16 


CALL 86-87 

Caps Lock Key 34, 36 

Carriage Return Character 222 
Carriage Return/Line Feed 66 
Cassette Recorder 22-23, 169-171 
Cassette Recorder, input jack 22 
Cassette Recorder, interface 22 
Cassette Recorder, output jack 22 
Cassette, LOAD 171 

Cassette, installation 169 
Cassette, operation 169-170 
Cassette, SAVE 170 

CATALOG 194-196 

CBASIC 40 

Character Set 20 

Character Set, alternative 20 
Character set, primary 20 

Charts 228 

Checksum 205 

CHR$ 77, 87, 93, 211, 299 

CLEAR 88 

Clearing the Display 278-279 
CLOSE 218, 223 

CLR 88-89 

Coefficient 49 
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COLOR 89-90, 134-135, 226-227 
Colors 89, 108, 227 

Colors, graphics 21 
Compiled Code 26 
Compiled Languages 40 
Compiler 26 

Compound Expression 55 
Compuserve 25 

CON 79, 90-91 
Concatenation 76 
Conditional Statement 71-72 
Constants 50 

CONT 79, 91, 95, 157-158 
Control Codes 279-280 
Control-C 79 

Controller Cards 24 

COS 92 

Counter 101-103 

CP/M 14, 25-26, 181, 273 
CPU 11 

Ctrl-D 211 

Ctrl-K 279 

Ctrl-L 278 

Ctrl-P, monitor 261-263, 270 
Ctrl-Q 276-277 

Ctrl-R 276-277 

Ctrl-V 279 

Ctrl-W 279 

Ctrl-Y, monitor 268-269, 271 
Ctrl-Z 279 

Ctrl-] 279 

Cursor Control 277-278 
Cursor Control Keys 35 


DATA 63-64, 92-93, 140-141, 144-145 
Data Types 46 
Debugging 98-99 

DEF FN 93-94 

DEL 94-95 

DELETE 203 

DELETE key 34 

Delimiter 63 

Density 178 

DIM 53-54, 95-98, 142 
Dimensions 53-54 

Direct Access 214 
Directory 194-195 

Disk Controller Card 181 


Disk Drive 169-224 

Disk I] 11, 23 

Disk I] System 181-182 

Disk Il System, installation 181, 
183-185 

Disk Operating Systems 181 

Diskette 171, 173-174, 199-202 

Diskette, Catalog 194-195 

Diskette, Directory 194-195 

Diskette, double-density 178 

Diskette, double-sided 178 

Diskette, handling rules 179-180 

Diskette, index hole 177 

Diskette, initialization 197-198 

Diskette, inserting 180 

Diskette, master 199-202 

Diskette, quad density 178 

Diskette, removing 180 

Diskette, single-density 178 

Diskette, single-sided 178 

Diskette, slave 199-202 

Diskette, slot number 191-192 

Diskette, volume number 192-194 

Diskette, write protection 178 

Diskette, 13 sectors 187-188 

Display 11 

Display Line 43 

Display Screen, formatting 65 

DOS 26, 151, 169, 175 

DOS 3.3 11, 181 

DOS Commands 189-220 

DOS, autostart boot 185 

DOS, booting 185-187 

DOS, DELETE 203 

DOS, drive specification 190-191 

DOS, Error Messages 292-294 

DOS, filenames 190 

DOS, LOAD 202 

DOS, LOCK 204 

DOS, monitor boot 186-187 

DOS, RENAME 203 

DOS, reserved words 286 

DOS, restoring 187 

DOS, SAVE 202 

DOS, slot specification 191 

DOS, VERIFY 204-205 

Double-Density Diskettes 178 

Dow Jones News & Quotes 25 


Down-Arrow 36 

DRAW 97-98, 108, 235, 244-245 
Drive Specification 190 

DSP 98 

Dynamic RAM 17 


Editing 45, 46 

END 42, 79 99 

Error Codes 130 

Error Message 45, 130, 189 

Error Messages, Applesoft BASIC 
287-289 

Error Messages, DOS 292-294 

Error Messages, Integer BASIC 
290-291 

ESC 4 277 

ESC 8 277 

ESC Key 36 

EXEC 208-210 

EXEC File 208-120 

Executing a Program 43 

EXP 100 

Expansion Slots 13-14 

Exponent 49 

Exponentiation 57 

Expressions 54-56 

Expressions, compound 55 

Expressions, simple 55 


File Pointer 219 

File Type 196 

File, locked 196 

File, size 196 

File, unlocked 196 
Filenames 190 

Files, data storage 221-222 
FLASH 100-101, 126, 281-282 
Flashing Format 20 
Floating Decimal Point 47 
Floating Point 27 

Floating Point Language 39 
Floppy Diskettes 171, 173 
FOR 69-71, 101-102, 138 
FORTRAN 27 

FP 188 

FRE 103 

Functions 75-76 


Index 313 


Game Controllers 133 

Game I/O Connector 24 

Game Paddles 24 

GET 69, 104 

GO 255 

GO, monitor 267 

GOSUB 72-75, 105-106, 128, 136-138, 
146 

GOTO 106, 128-129, 136-137 

GR 107, 225-226 

Graphics 225 

Graphics Mode, high resolution 
20-21 

Graphics Mode, low resolution 20-21 

Graphics Modes 225 

Graphics, colors 21, 89, 108 

Graphics, full screen 226 

Graphics, high resolution 97-98, 
108-110, 113, 166-168, 232-234 

Graphics, low resolution 107, 111, 
152-154, 225-228 

Graphics, shape 97-98, 149, 151-152, 
235-244 

Graphics, with text 226-227 

Greeting Program 197-198 


Hard Disks 171-172 

Hard Sectoring 176-177 

HCOLOR 107-108, 112-113, 233 

HGR 108-109, 232-233 

HGR2 109-110 

High Resolution Graphics 20-21, 
97-98, 108-110, 113, 166-168, 
232-234 

Housekeeping 103 

HIMEM 110-111, 123 

HLIN 89, 107, 111, 227-228 

HOME 112, 281-282 

HPLOT 108, 112-113, 234 

HTAB 113-114, 139, 281 


IF 71-72, 82, 114-115 
Immediate Mode 40, 41 
IN# 115-116, 186 

Index Hole 176 

Index Variables 70 

INIT 497-199 
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Initializing, diskettes 197-198 

INPUT 67-68, 117-118 

INPUT prompt 67-68 

Installation 29 

INT 116, 188 

Integer 48 

Integer BASIC 11, 27, 39, 169 

Integer BASIC, error messages 
290-291 

Integer BASIC, prompt 39, 118 

Integer BASIC, reserved words 286 

Integer BASIC, switch to Applesoft 
188 

Interpreters 26-27 

Interpreted Languages 40 

INVERSE 116-117, 126, 281-282 

Inverse Command, monitor 261-263, 
270 

Inverse Format 20 

Inverse Video 116-117 

IOU Circuit 14 


JMP 264-268 
Jobs, Stephen 11 
Joystick 24 

JSR 263, 267 


Keyboard 11 
Keyword 44 


Language Translators 26 
LEFT$ 76, 118-119 

LEN 119 

LET 62, 120 

Line Numbers 41, 85-86 
Links 196-197 

LIST 44-45,120-121 

List Command, monitor 265-266 
Listing a Program 44 
LOAD 121-122, 202 
LOAD, cassette 171 
LOCK 204 

Locked File 195 

LOG 122 

Logical Operators 59-61 
Logo 27 

LOMEM 110, 123-124 
Loop 70-71, 101-106 


Low Resolution Graphics 20-21, 107, 
111, 152-154, 225-228 


Machine Language 249 

Machine Language Programs 263 

Machine Language Subroutine 86-87 
110 

Main Board 13 

MAN 86, 124 

Mantissa 49 

MAXFILES 207-208 

Master Diskette 199-202 

Memory Change, monitor 269 

Memory Dump, monitor 252-253 

Memory Examine, monitor 251-252 

Memory Examine, monitor 269 

MID$ 76, 123-125 

Mini-Assembler 263-264 

Mini-Assembler, activating 264 

Mini-Assembler, program entry 
264-265 

Mini-Assembler, return to monitor 
265 

Mini-floppy Diskettes 174 

Mixed Modes 22 

MMU Circuit 14 

Mneumonic 263-264 

Modem 25 

MON 205-206 

Monitor 18-19, 169, 205-206, 249-271 

Monitor DOS boot 186-187 

Monitor, Ctrl-P 261-263, 270 

Monitor, Ctrl-Y 268-269, 271 

Monitor, GO 255,267 

Monitor, activating 249-250 

Monitor, address values 251 

Monitor, changing memory 253-255 

Monitor, command characters 251 

Monitor, commands 251 

Monitor, custom command 268-269 

Monitor, data values 251 

Monitor, deactivating 249-250 

Monitor, inverse command 261, 270 

Monitor, list command 265-266 

Monitor, memory change 269 

Monitor, memory dump 252-253 

Monitor, memory examine 251-252, 
269 


Monitor, normal command 261, 270 

Monitor, read command 259 

Monitor, register examine 253, 269 

Monitor, subroutines 301-307 

Monitor, verify 256-259, 261 

Monitor, write command 259 

Move Command, monitor 255-256, 
270 

Muffin 187-188 

Multiple Statement Program lines 
43, 44 


Nested Loop 71, 102 

Nesting 102 

NEW 42, 125-126 

NEXT 69-71, 101-102, 138 

NO END Error 99 

NO TRACE 127 

NOMON 205-206 

NORMAL 126 

Normal Command, monitor 261-263, 
270 

Normal Format 20 

NOT 59-61, 126-127 

Null Command 216 

Numeric Data 46-47 


ON 128-129, 136-138, 146 

ON, GOSUB 75, 128-129 

ON, GOTO 73, 128-129 

ONERR 129, 131, 145 

OPEN 214,219-220 223 

Open Apple Function Key 34, 36 
Operands 55 

Operating System 26 

Operator 55-56 

OR 59-61, 131-132 


Paddles 133 

Page-Zero 254 

Parentheses 55-56 

Parallel Communications 24 
Parallel Interface Card 23-24 
PASCAL 27, 181, 273 

PDL 133 

PEEK 78,133-134 

PFS 28 

PILOT 27 


Index 315 


Pixel 225 

Plan 80 28 

PLOT 89, 107, 134 ,227 
POKE 78, 135-136 

POP 136 

POS 138-139 

POSITION 219-220 

Power Supply 17 

PR# 66, 140, 186, 299-301 
Primary Character Set 20 
PRINT 65, 77, 139-140, 156 
PRINT, commas 65 
PRINT, semicolon 66 
Printer 23-24 

Printer 298-299 

Program Debugging 98-99 
Program Execution 43 
Program Lines 43 
Program Mode 40, 41 
Prompt 67-68,188 


Quad-Density Diskettes 178 


Quick File II 2 
RAM 11, 13-14 
RAM 16 


RAM, dynamic 17 
RAM, static 17 
Random File Access 212-214 
Random File, CLOSE 223 
Random File, OPEN 223 
Random File, READ 223 
Random File, WRITE 223 
Random Numbers 147-148 
READ 63-64, 92-93, 140-141, 145, 
216-218, 219-220, 223, 224 
Read Command, monitor 259 
Read/Write Head 176 
RECALL 141-143, 158, 171 
Record Length 212 
Register Examine, monitor 253, 269 
Relational Expression 54 
Relational Operators 56, 58 
REM 144 
Remark Statements 62 
RENAME 203 
Reserved Word 44, 285-286 
Reset Key 37, 80 
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RESTORE 64, 140,144 
RESUME 130-131, 145-146 
RETURN 34, 36, 74, 128, 105-106, 146 
Reverse Video 116-117 
RF Modulator 18-19 
RIGHT$ 141-147 

RIGHT$ 76 

RND 147-148 

ROM 11, 13 16 

ROT 149, 235, 244 

RTS 267 

RUN 150 

Run-Time Monitor 26 


S$ 192 

SAVE 150-151, 202-203 

SAVE, cassette 170 

SCALE= 149, 151-152, 235, 244 
Scientific Notation 49-50 
SCRN 152-154, 228 

Scrolling 279 

Sectors 174-177 

Self-Test 31 

Sequential File 212-222 
Sequential 212-213 
Sequential File, CLOSE 218 
Sequential File, OPEN 214 
Sequentila File, READ 216-218 
Sequential File, WRITE 215-216 
Serial Communications 24 
Serial Interface Card 23-24 
Shape 149, 151-152 

Shape Table 155,235-247 
Shape Table, directory 240 
Shape Table, programming 246-247 
Shape Table, saving 243 

Shift 35 

SHLOAD 155, 235, 243-244 
Simple Expressions 55 
Single-Density Diskette 178 
SIN 155 

Slave Diskette 199-202 

Slot 191-192 

Slot Specification 191 

Soft Sectoring 175-177 

Soft Switch 17-18 

Software 25-27 

Solid Apple Function Key 34, 36 


Source Code 26 

Space Bar 35 

SPC 156 

Speaker 17-18 

Special Character Keys 34 
SPEED 156 

SQR 75-76, 157 
Statement 43 

Static RAM 17 

STEP 70, 101-102 

STOP 80, 157-158 

STORE 141-143, 158, 171 
STR$ 158-159 

String Variables 51-52 
Strings 46, 95-96 
Subroutines 73-75 
Subscript 53 

Subscripted Variables 53 
Super Serial Card 25 
Switch Box 18 

Syntax, DOS 194 

System Master Diskette 11, 181 
System Monitor 249-271 
TAB 139, 159-160 

Tab Key 34, 36 

Tab Stops 65 

Tabbing 281 

Tables 52 

TAN 85, 161 

TEXT 107, 161 

Text Data 46 

Text File 212 

Text Mode 225 

Text Mode, 40 column 20 
Text Mode, 80 column 20 
The Source 25 

THEN 71-72, 82, 114-115 
Tokens 285 

TRACE 127 

TRACE 161-162 
Track/Sector List 196-197 
Tracks 174-175 
Troubleshooting 29 
Truncated 52 

TV Set 18-19 


Unary Operators 57 
Unlocked File 195 


Up-Arrow 36 
Uppercase-Restrict Mode 282 
USR 162 


V 193 

VAL 104, 163 

Variable Name 51-52 

Variables 50-52 

Variables, subscripted 53 

Vectors 236-239 

VERIFY 204 

Verify Command, monitor 256-259, 
261 

Video Display 18 

Video Display, Inverse 116-117 

Video Display, reverse 116-117 

Visicalc 28 

VLIN 89, 107, 163-164, 227-228 

Volume Specification 192-193 

Volume Specification 192-193, 195 

VTAB 164-165 


WAIT 165-166 

Winchester Disks 171-173 
Wordstar 28 

Wozniak, Stephen 11 

WRITE 219-220, 223-224 

Write Command, monitor 259 
Write-Enable Notch 178 
Write-Protect Notch 178-179 


X-Register 267 

XDRAW 108, 149, 151, 166-168, 235, 
244-246 

Y-Register 267 


Z80 26 
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Special Characters 


40-Column Mode 65-66 

6502 Microprocessor 14 

6502B Microprocessor 13, 14 

80-Column Mode 65-66 

80-Column Board 273-283 

80-Column Board, activating 274-275 

80-Column Board, deactivating 
275-276 

80-Column Board, selecting 40 
columns 276-277 

80-Column Board, selecting 80 
columns 276-277 

80-Column Text Card 14 
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, 
The Apple Ile personal computer has impressive computing capabilities. 
The APPLE Ile USER’S HANDBOOK provides clear, concise, and complete 
instructions which allow the user to master these capabilities. 


The APPLE Ile USER'S HANDBOOK is written in a simple, concise manner 
so that even a first-time user can understand the Apple Ile, yet it still con- 
tains a wealth of advanced information for the experienced user A com- 
plete guide to the operation and programming of the Apple Ile and its 
related peripheral equipment is included. : 


The following topics are covered in detail: 


e Installation and Operation 

e BASIC Programming 

e DOS and Disk II Usage 

e Printer Installation and Operation 

e Graphics and Sound 

e 80 Column Card 

as relalicels 

e Reference Guide to Integer and 
Applesoft BASIC Commands 

e Reference Guide to DOS Commands 


The APPLE Ile USER’S HANDBOOK is a must for any user or potential user 
of the Apple Ile computer. 
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